Ks0397 keyestudio EASY plug Super Starter Kit for Arduino STEM EDU

From Keyestudio Wiki
Jump to: navigation, search
Keyestudio Super Starter Kit for Arduino STEM EDU

Contents

Kit Description

The keyestudio EASY PLUG super starter kit is based on Mixly blocks coding, very easy to use and flexible.
This kit includes everything you need to complete Mixly projects that will teach you how to control and read external sensors and displays, control matrix, learn Mixly Blocks programming, and much more.
Although you have a few or even no electronics related knowledge, you can use this kit to realize your creative ideas as long as you want to.
After using this kit you’ll have the know-how to start creating your own amazing experiments. Share your own creative works with your intimate family, friends or classmates. Let’s get started right now!


Kit List

No. Product Name Quantity Picture
1 EASY plug Control Board V2.0 1
thumb
2 EASY plug White LED Module 1
thumb
3 EASY plug Blue LED Module 1
thumb
4 EASY plug Red LED Module 1
thumb
5 EASY plug thin-film pressure sensor 1
thumb
6 EASY plug Analog Sound Sensor 1
thumb
7 EASY plug Water Level Sensor 1
thumb
8 EASY plug Potentiometer Sensor 1
thumb
9 EASY plug Analog Alcohol Sensor 1
thumb
10 EASY plug LM35 Temperature Sensor Module 1
thumb
11 EASY plug Digital Tilt Sensor Module 1
thumb
12 EASY plug Steam Sensor 1
thumb
13 EASY plug Hall Magnetic Sensor 1
thumb
14 EASY plug Crash Sensor 1
thumb
15 EASY plug Digital Push Button 1
thumb
16 EASY plug Reed Switch Module 1
thumb
17 EASY plug Line Tracking Sensor 1
thumb
18 EASY plug Photo Interrupter Module 1
thumb
19 EASY plug Single Relay Module 1
thumb
20 EASY plug ADXL345 Acceleration Module 1
thumb
21 EASY plug DHT11 Temperature and Humidity Sensor 1
thumb
22 EASY plug 8x8 LED Matrix 1
thumb
23 EASY plug 1602 LCD Module 1
thumb
24 EASY plug 4-digit LED display 1
thumb
25 200mm blue RJ11 cable 5
thumb
26 300mm blue RJ11 cable 3
thumb
27 USB cable 1
thumb


Getting Started with Mixly

Introduction for Mixly

Mixly

Mixly is a free open-source graphical Arduino programming software, based on Google’s Blockly graphical programming framework, and developed by Mixly [email protected] BNU.
It is a free open-source graphical programming tool for creative electronic development; a complete support ecosystem for creative e-education; a stage for maker educators to realize their dreams.
Although there is an Ardublock graphical programming software launched by Arduino official, Ardublock is not perfect enough, and many common functions cannot be realized.


Interface Functions of Mixly

System Functions

Look at the main interface of Mixly, it includes five parts, that is, Blocks selection, code edit, text code (hidden), system function and message prompt area. Shown below.
3.1-1.png


Some common functions:
Through this interface, you can complete the code compile、upload、save and manage. It support four remove methods: drag it left out code window, or drag to Recycle Bin, delete key, or right-click to delete block. It supports four languages: English、Español (Spanish)、中文简体(Chinese Simplified)、中文繁体(Chinese Traditional).
3.1-2.png

In/Out Block

3.2-1.png

No. BLOCK ICON DEFINITION
1
3.2-2.png
Returns HIGH or LOW voltage
2
3.2-3.png
Write digital value to a specific Port.

Digital Output: set the HIGH or LOW output for IO pins

3
3.2-4.png
Returns a digital value of a specific Port.

Digital IO Read Pin, generally used to read the HIGH or LOW level detected by Digital sensor

4
3.2-5.png
Write analog value between 2 and 255 to a specific Port.

Analog Output: set the Analog value output by Analog IO pins (0~255).

5
3.2-6.png
Returns value between 0 and 1023 of a specific Port.

Analog IO Read Pin, generally used to read the Analog value detected by Analog sensor.

6
3.2-7.png
External Interrupts function, with three trigger interrupt modes RISING, FALLING, CHANGE.
7
3.2-8.png
Detachs interrupt to a specific Port.

Turn off the given interrupt function.

8
3.2-9.png
Set the IO pins as Output or Input state
9
3.2-10.png
Read the continuous time of HIGH or LOW pulse from IO pins.( generally used for ultrasonic ranging)
10
3.2-11.png
Read a pulse (either HIGH or LOW) on a pin within a time set in timeout.
11
3.2-12.png
Set the ShiftOut data pin, clock pin. Output the data needed from the bitOrder MSBFIRST or LSBFIRST (Most Significant Bit First, or, Least Significant Bit First).

Generally used for controlling the 74HC595 CHIP.

12
3.2-13.png
This is the function interface under Normal mode. If select Advanced mode, the functions will be more.


For example:
Connect your Arduino Uno board, then follow the steps below to light the Pin13 led on Arduino UNO.
3.2 led D13.PNG

Control Block

Control.PNG

No. BLOCK ICON DEFINITION
1
3.3-1.png
Initialization (run only once)
2
3.3-2.png
End the program, means the program will stop running when use this block.
3
3.3-3.png
Delay function, click to select ms or us

(pause the program for the amount of time (in milliseconds) specified as parameter. There are 1000 milliseconds in a second.)

4
3.3-4.png
if_do function (first evaluate a value be true or false, if a value is true, then do some statement.

You can click the blue gear icon to select the else if block or else block.)

5
3.3-5.png
switch function. You can click the blue gear icon to select the case block or default block. (used to evaluate several programs then execute the corresponding function matched with program.)
6
3.3-6.png
Equal to for statement.
7
3.3-7.png
A while loop statement.
8
3.3-8.png
break function, used to exit from the containing loop.
9
3.3-9.png
millis() function, returns the system running time since the program started.

(The unit can be ms (milliseconds) or μs(microsecond)).

10
3.3-10.png
Timer interrupt function, that is, set a trigger interrupt for the amount of time (in milliseconds) specified as parameter.
11
3.3-11.png
Timer interrupt start block
12
3.3-12.png
Timer interrupt stop block


For example:
Compile and upload the program below to your Arduino board, you should see Pin13 LED on Arduino UNO continue to flash.(with an interval of 1s, equal to 1000ms)
3.3 flash.PNG


Math Block

3.4.png

No. BLOCK ICON DEFINITION
1
3.4-1.png
A number
2
3.4-2.png
Click to select the Arithmetic Operators:

+(addition); -(subtraction); x (Multiplication); ÷(division);  %(remainder); ^(bitwise xor)

3
3.4-3.png
Click to select the & (bitwise end); l (bitwise or); << (bitshift left); >> (bitshift right)
4
3.4-4.png
Click to select the sin; cos; tan; asin; acos; atan; ln; log10; e^; 10^; ++ (increment) ;

-- (decrement)

5
3.4-5.png
Click to select the Round; Ceil; Floor; abs; sq; sqrt

Round: Returns the integer part a number using around.
Ceil: Returns the integer part a number using ceil.
Floor: Returns the integer part a number using floor.
abs: Return the absolute value of a number.
sq: Return the square of a number.
sqrt: Return the square root of a number.

6
3.4-6.png
If select the max, returns the larger number;

if select the min, returns the smaller number.

7
3.4-7.png
Initialize the random seed
8
3.4-8.png
Return a random integer between the two specified limits, inclusive.
9
3.4-9.png
Constrain a number to be between the specified limits (inclusive).

(generally used to constrain an analog value read from sensor)

10
3.4-10.png
Map a number from the first interval to the second interval.

(For instance, potentiometer-controlled servo, map the range of potentiometer (0, 1023) to the angle of servo (0, 180)).


Text Block

3.5.png

No. BLOCK ICON DEFINITION
1
3.5-1.png
character string: a letter, word, or line of text.
2
3.5-2.png
A character
3
3.5-3.png
Creates a piece of text by joining together two piece of text.

( Here Hello join Mixly equals HelloMixly)

4
3.5-4.png
Converts a string into an integer or an float.
5
3.5-5.png
Returns the char corresponding to an ASCII code

(Decimal number 97 corresponding to a)

6
3.5-6.png
Returns the ASCII code corresponding to a char.
7
3.5-7.png
Converts a number into a string.
8
3.5-8.png
Calculates the length of a string
9
3.5-9.png
Output the char of a string (the char at 0 of hello is h)
10
3.5-10.png
The first string equals or startsWith or endsWith the second string, returns 1, otherwise returns 0.

(if equals, both strings are abc, returns 1.)

11
3.5-11.png
Returns a decimal value of the first string subtracts the second string.


List Block

3.6.png

No. BLOCK ICON DEFINITION
1
3.6-1.png
Create a list with any number of items
2
3.6-2.png
Creats a list from a text. (int mylist [ ]={0,0,0};)
3
3.6-3.png
Creats a list from a text. (int mylist [ ]={0,0,0};)
4
3.6-4.png
Returns the value of at the specified position in a list.
5
3.6-5.png
Sets the value of at the specified position in a list.

Set the first item in mylist to another item.


Logic Block

3.7.png

No. BLOCK ICON DEFINITION
1
3.7-1.png
logic comparision

=: Return true if both inputs equal each other.
≠: Return true if both inputs are not equal to each other.
<: Return true if the first input is smaller than the second input.
≤ : Return true if the first input is smaller than or equal to the second input.
>: Return true if the first input is greater than the second input.
≥ : Return true if the first input is greater than or equal to the second input.

2
3.7-2.png
and:Return true if both inputs are true;

or: Return true if at least one of the inputs is true

3
3.7-3.png
Returns true if the input is false. Returns false if the input is true.
4
3.7-4.png
Returns either true or false.
5
3.7-5.png
Returns null
6
3.7-6.png
If the first number is true, the second number is returned, otherwise the third number.



Variable Block

3.8.png

No. BLOCK ICON DEFINITION
1
3.8-1.png
Declare and initialize a variable.

Click to select int, long,float, boolean, byte,char, string

2
3.8-2.png
Define the data types


For example: LED breath
You need an Arduino Uno and one LED module. Connect the control pin of LED module to Pin 3 of Uno board (or other pins with “~”,that is, those pins can output PWM signal). LED will gradually light then gradually dim, repeatedly.
3.8 LED breath.PNG


SerialPort Block

3.9.png

No. BLOCK ICON DEFINITION
1
3.9-1.png
Set the serial buad rate to 9600
2
3.9-2.png
Write the specified number, text or other value.
3
3.9-3.png
Print the specified number, text or other value on monitor.
4
3.9-4.png
Print the specified number, text or other value on newline of monitor.
5
3.9-5.png
Print the specified number in hexademical format on newline of monitor.
6
3.9-6.png
If the serial port is available, it returns true, otherwise returns false.

(generally used in Bluetooth communication)

7
3.9-7.png
Returns a string in serial port
8
3.9-8.png
A string read from serial port to a string variable, pause until read the specified character.
9
3.9-9.png
Read the serial data by byte (generally used to read the value sent from Bluetooth) (delete the data has been read)
10
3.9-10.png
Wait for the output data completed
11
3.9-11.png
Set the software serial port

(call this function if need to use several serial ports)

12
3.9-12.png
Event function trigger by serial port data, that is, serial port is ready to call this function.

(equal to an interrupt function)


For example: serial communication
Done uploading the code, open the Arduino monitor, then enter a “hello” on the top bar, and click Send, it will print out “hello,world”.
3.9 Serial port -1.PNG

3.9-13.png


Communicate Block

Communicate.PNG

No. BLOCK ICON DEFINITION
1
3.10-1.png
Do something when receiving infrared signals.


3.10-1-1.png

2
3.10-2.png
Sends infrared signals of the specified types.

IR transmitter sends the data, here use the libraries, only PIN3 port.

3
3.10-3.png
Enable IR decoding
4
3.10-4.png
Print the Infrared signal in RAW types when receiving it.
5
3.10-5.png
Sends RAW infrared signals (set the pin number, list, length of list and IR frequency)



For example:
You need an Arduino Uno board, an IR receiver module and an IR remote control.
Connect the signal pin of IR receiver to Digital pin 3 of Uno board, then upload the code and open the monitor. If send a signal to an IR receiver module using an IR remote control, you should see the monitor show the corresponding signal data.
3.10 ir.PNG


Sensor Block

Sensor.PNG


No. BLOCK ICON DEFINITION
1
3.11-1.png
Set the Trig and Echo pin of ultrasonic sensor.

Returns the distance of ultrasonic sensor measured. (unit: cm)

2
3.11-2.png
Set the control pin of DHT11 temperature and humidity sensor.

Returns the temperature or humidity of DHT 11 sensor measured.

3
3.11-3.png
Set the control pin of DHT11 temperature and humidity sensor.

Returns the temperature or humidity of DHT 11 sensor measured.


For example: ultrasonic ranging
Connect the Trig pin of ultrasonic sensor to Digital 1 of Uno, Echo pin to D2, then upload the code and open the monitor, you should see the distance value, updating once per 100ms.
3.11-4.png


Actuator Block

Actuator.PNG

No. BLOCK ICON DEFINITION
1
3.12-1.png
Sets the servo pin;

Moves between 0-180 degree;
Delay time for servo to rotate.

2
3.12-2.png
Returns that degree with the last servo move.

Read the degree of servo connected to IO pin set

3
3.12-3.png
Set the pin and specified frequency for buzzer to play sound.
4
3.12-4.png
Stop playing sound


For example:
Connect the signal end of servo to Digital 0 of Uno, then upload the code below, servo will rotate 90 degrees.
Note: Delay 100ms is the time required for servo to move.
3.12-5.png



Monitor Block

Monitor.PNG

No. BLOCK ICON DEFINITION
1
3.13-1.png
Set the IIC LCD1602 address
2
3.13-2.png
Input the value on LCD line 1 and line 2 from left to right.
3
3.13-3.png
Set the row and column of LCD to print the char
4
3.13-4.png
Clear the LCD screen
5
3.13-5.png
Set the control pin and the number of RGB light.
6
3.13-6.png
Set the RGB light pin, light number and brightness
7
3.13-7.png
Set the control pin, light number and color. (click to select the color)
8
3.13-8.png
Clear the data, namely turn off digital display
9
3.13-9.png
Four-digit display, displaying abcd.
10
3.13-10.png
Turn on or off the digitdisplay

(here turn on the first digitdisplay)


For example: serial communication
Separately connect the SDA (A4) and SCL (A5) of Arduino Uno to SDA and SCL pins of IIC LCD1602, then set the address of your LCD1602 screen, the LCD address we used here is 0x27. Then upload the code, LCD screen has two lines, you should see the line 1 print HELLO, and line 2 print 123456789.

3.13 LCD16002.PNG


Functions Block

Function.PNG

No. BLOCK ICON DEFINITION
1
3.14-1.png
Creates a function with no output.

Click the blue icon to set the procedure parameter.(no return value)

2
3.14-2.png
Creates a function with an output.

Click the blue icon to set the procedure parameter.
(with return value and can set the data types)

3
3.14-3.png
If a value is true, then return a second value.


For example: ultrasonic ranging
Below is an example code for line tracking car. We use three tracking modules (left to D6, middle to D7, right to D8). of course you need a tracking car to test it. First edit the forward, backward, turn left, turn right and stop into functions block. Then compile and upload the code below.
图片1-mixly 3.14.png

3.14-4.png



Installing Arduino Software

When you get the control board, first you should install the Arduino software and driver. We usually use the software Arduino 1.5.6 version. You can download it from the link below: https://www.arduino.cc/en/Main/OldSoftwareReleases#1.5.x Or you can browse the ARDUINO website to download the latest version from this link, https://www.arduino.cc, pop up the following interface.
KS0313-1.png

Then click the SOFTWARE on the browse bar, you will have two options ONLINE TOOLS and DOWNLOADS.
KS0313-2.png

Click DOWNLOADS, it will appear the latest software version of ARDUINO 1.8.5 shown as below.
KS0313-3.png

In this software page, on the right side you can see the version of development software for different operating systems. ARDUINO has a powerful compatibility. You should download the software that is compatible with the operating system of your computer.
We will take WINDOWS system as an example here. There are also two options under Windows system, one is installed version, the other is non-installed version. For simple installed version, first click Windows Installer, you will get the following page.

KS0313-4.png

KS0313-5.png

This way you just need to click JUST DOWNLOAD, then click the downloaded file to install it.
For non-installed version, first click Windows ZIP file, you will also get the pop-up interface as the above figure.
Click JUST DOWNLOAD, and when the ZIP file is downloaded well to your computer, you can directly unzip the file and click the icon of ARDUINO software to start it.


Installing Arduino (Windows)

Install Arduino with the exe. Installation package downloaded well.
thumb

Click“I Agree”to see the following interface.
thumb

Click “Next”. Pop up the interface below.
thumb

You can press Browse… to choose an installation path or directly type in the directory you want.
Then click “Install” to initiate installation.
thumb

Wait for the installing process, if appear the interface of Window Security, just continue to click Install to finish the installation.
thumb


Installing Driver

Next, we will introduce the driver installation of UNO R3 development board. The driver installation may have slight differences in different computer systems. So in the following let’s move on to the driver installation in the WIN 7 system.
The Arduino folder contains both the Arduino program itself and the drivers that allow the Arduino to be connected to your computer by a USB cable. Before we launch the Arduino software, you are going to install the USB drivers.

KS0001-1.jpg
Plug one end of your USB cable into the Arduino and the other into a USB socket on your computer. When you connect UNO board to your computer at the first time, right click the icon of your “Computer” —>for “Properties”—> click the “Device manager”, under “Other Devices”, you should see an icon for “Unknown device” with a little yellow warning triangle next to it. This is your Arduino.

Driver 1.png
Then right-click on the device and select the top menu option (Update Driver Software...) shown as the figure below..
Driver 2.png

It will then be prompted to either “Search Automatically for updated driversoftware” or “Browse my computer for driver software”. Shown as below. In this page, select “Browse my computer for driver software”.
Driver 3.png

After that, select the option to browseand navigate to the “drivers” folder of Arduino installation.
KS0286-4.png

Click “Next” and you may get a security warning, if so, allow the software to be installed. Shown as below.
Driver 5.png

Once the software has been installed, you will get a confirmation message. Installation completed, click “Close”.
Driver 6.png

Up to now, the driver is installed well. Then you can right click “Computer” —>“Properties”—>“Device manager”, you should see the device as the figure shown below.
Driver 7.png



Let’s Get Started With Your Projects

Project 1: Hello World


Overview

Arduino quickstart.jpg

This project is very simple. You can use only a main board and a USB cable to display the “Hello World!”. It is a communication experiment between the EASY Plug control board and PC. This is an entry experiment for you to enter the Arduino programming world.
Note that need to use a serial communication software, Arduino IDE. In the above part, you can check the detailed use of Arduino IDE.


Component Required:

  • EASY plug control board*1
  • USB cable*1


Component Introduction:

thumb
The processor used in keyestudio EASY plug control board V2.0 is ATmega328. It has 5 single Digital ports labeled D5 to D9 (of which 3 can be used as PWM outputs), 1 dual-digital interface (D3-D4), 4 analog inputs (A0-A3), a Joystick socket (D2-A6-A7), a SPI, a serial port and an IIC communication interface. Also with a USB connection, a power jack, two ICSP headers and a reset button. It breaks out the IO ports with RJ11 6P6C plug.


Connect It Up
Connect the control board to your computer via a micro USB cable.
thumb

Upload the Code
Below is an example code for displaying the Hello World!

int val;
int ledpin=13;
void setup()
{
Serial.begin(9600);
pinMode(ledpin,OUTPUT);
}
void loop()
{
val=Serial.read();
if(val=='R')
{
digitalWrite(ledpin,HIGH);
delay(500);
digitalWrite(ledpin,LOW);
delay(500);
Serial.println("Hello World!");
}
}


Select the Arduino Board
Open the Arduino IDE, you’ll need to click the “Tools”, then select the Board that corresponds to your Arduino.
thumb


Select your serial port
Select the serial device of the Arduino board from the Tools | Serial Port menu.

Note: to avoid errors, the COM Port should keep the same as the Ports shown on Device Manager.

thumb thumb

Then click verify button to check the errors. If compiling successfully, the message "Done compiling" will appear in the status bar.
thumb

After that, click the “Upload” button to upload the code. If the upload is successful, the message "Done uploading" will appear in the status bar.
thumb


Open the Serial Monitor
After that, click the monitor button to open the serial monitor.
thumb

Then set the baud rate to 9600, enter an “R” and click Send, you should see the RX led on the board blink once, and then D13 led blink once, finally "Hello World!" is showed on the monitor, and TX led blink once.
Congrats! Your first simple program is complete.

thumb

Note: In this project, we take Arduino code as an example to show Hello World. But in the following projects, we will take Mixly Code as example to start the experiments. It will be more simple and easier for you to get understand of the program.


How To Get Started With Mixly Projects

* Import the Library
1) Begin with the Mixly projects, the first step you should import the corresponding library.
Open the Mixly 0.998 software, click Import. Shown below.
thumb

2) Open the folder we provided, you can double-click to open the library KS_EasyPulg

thumb

thumb

thumb

3) If import the custom library successfully, you should see it on the Mixly blocks interface. Shown below.
thumb


Start with Mixly Project - Saying Hello World

1) Hookup Guide
Connect the control board to your computer via a micro USB cable.
thumb

2) Open the Program
Click Open to open your first program Hello World. Follow the steps below.
thumb

thumb

thumb

thumb

In fact, you can double click or directly drag the program to open Hello World. Then you should see the Blocks code, shown below.
thumb

thumb

After that, select the proper Board and Port. Upload the code to your EASY Plug control board.
thumb


3) Displaying Hello World
Finally, upload the code successfully, open the monitor and set the baud rate to 9600, you should be able to see the Hello World is showed on the monitor. Congrats! You make it !
thumb


4) Check Arduino Code
What’ more, you can also click to check the Arduino code on the right side. Amazing! So powerful the Mixly blocks code is!
thumb

Is it more easy and simple to play the Mixly projects? Try your first Mixly blocks projects right now. Begin with the following projects to motivate your creations!


Project 2: LED Light

Overview
To start off the EASY Plug sensor module, we will work on an LED. That’s right - it is as simple as turning a light on and off. It might not seem like much, but establishing this important baseline will give you a solid foundation as we work toward more complex experiment.

Keyestudio EASY plug LED Module

Component Required

  • EASY plug control board*1
  • EASY plug LED Module *3
  • RJ11 cable*1
  • USB cable*1


Component Introduction:
The LED light modules have shiny colors, ideal for Arduino starters. It can be easily connected to IO/Sensor shield.
Note: this module needs to be used together with EASY plug control board. You can also choose other LED to emit different color of light like blue, green, yellow and red.

  • Sensor type: Digital
  • Interface: Easy plug
  • PH2.54 socket


Connect It Up
Connect the EASY Plug LED module to control board using an RJ11 cable.
thumb


Example 1: Light up LED

Upload the Code
Below is an example code for lighting up an LED.
thumb

What You Should See
The LED is turned on. If it doesn’t, make sure you have assembled the circuit correctly and verified and uploaded the code to your board.
thumb


Example 2: LED Blink

Upload the Code
Below is an example code for LED blinking.
thumb

What You Should See
thumb
The LED will flash on for one second, then blink off for one second.
If it doesn’t, make sure you have assembled the circuit correctly and verified and uploaded the code to your board.
thumb

Little Knowledge:
If you want to make the LED flash on and off more quickly or slowly, you can modify the Delay time here.

thumb
Thank you! Enjoy the following programming.


Example 3: LED Breath

Here do you know how to connect the LED module? Check the code.
Test Code
Below is an example code for one LED breathing.

thumb

Little Knowledge:
Here no connection diagram, which port should you choose? Yeah, Pin 5.
See the code, you can modify the connection pin here.

thumb

What You Should See
The LED gradually becomes brighter for one second, then gradually dimming for one second.
thumb
If it doesn’t, make sure you have assembled the circuit correctly and verified and uploaded the code to your board.


Example 4: Brighten and Dim

Hookup Guide
Connect the three EASY Plug LED modules to control board using RJ11 cables. Connect a red LED to D9, white LED to D6, blue LED to D5.
thumb

Upload the Code
Below is an example code for three LED modules experiment.
thumb

thumb


What You Should See
The three LEDs are gradually brighter then gradually off one by one, circularly.
If it doesn’t, make sure you have assembled the circuit correctly and verified and uploaded the code to your board.
thumb

thumb

thumb


Troubleshooting

  • LED Not Lighting Up?

If upload the code successfully, but LED still not lights up. Make sure your board and LED module are connected correctly.

  • Program Not Uploading?

This happens sometimes, the most likely case is a confused Board and serial port, you should firstly select your proper board and port.
thumb


Project 3: Line Tracking

Overview
If you want to build a line tracking robot, the easiest way is to use a line tracking sensor. Line following is the most basic function of smart mobile robot. We designed this new generation of line tracking sensor to be your robot's powerful copilot all the way. It will guide your robot by telling white from black quickly and accurately, via TTL signal.

Component Required:

  • EASY plug control board*1
  • EASY plug Line Tracking Sensor *1
  • EASY plug LED Module *1
  • RJ11 cable*1
  • USB cable*1


Component Introduction:

Keyestudio EASY plug Line Tracking Sensor

The Line Tracking Sensor can tell white from in black or black from white accurately.
The single line-tracking signal provides a stable output signal TTL for a more accurate and more stable line.
The working principle is simple, using infrared light's different reflectivity for different color, and converting the strength of the reflected signal into current signal.

  • Power supply: 5V
  • Operating current: <10mA
  • Operating temperature: 0℃~ 50℃
  • Output Level: TTL (Black for LOW output, White for HIGH output)
  • High quality connector


Connect It Up
Connect the EASY Plug Line Tracking sensor and LED module to control board using RJ11 cables.
thumb


What You Should See
Done uploading the code to board, open the serial monitor and set the baud rate to 9600, then you can see the data is printed on the monitor, and will control LED on.
thumb

thumb

thumb



Project 4: Push Button

Overview
In this project, we’ll be looking at the one of the most common and simple inputs- a push button. It is an elegant way to control power to your project. Press once to turn on, then press again to turn off. Press to release pleasure!
Component Required:

  • EASY plug control board*1
  • EASY plug Digital Push Button *1
  • EASY plug LED Module *1
  • RJ11 cable*1
  • USB cable*1


Component Introduction

Keyestudio EASY plug Digital Push Button

The EASY Plug Push-button module is a tidy little design that lets you control a DC power source using an everyday tactile button.
This basic application module is widely applied to Arduino, Raspberry Pi platforms.
When the button is pressed, it outputs HIGH level signal; if release the button, it outputs LOW level signal.
You can simply connect to an IO port to have your first taste of Arduino.

  • Supply Voltage: 3.3V to 5V
  • Large button and high-quality top cap
  • Sensor type: Digital


Connect It Up
Connect the EASY Plug push button sensor and LED module to control board using RJ11 cables.
thumb


Example 1: Button Controlled Light

Upload the Code
Below is an example code.
thumb

What You Should See
Powered up and upload well the code, press down the button, LED module is turned on. While release the button, LED is off.
thumb

thumb
Open the monitor, it will print out the value read from the button.
thumb

thumb


Example 2: Simulating Table Lamp

Upload the Code
Below is an example code.
thumb

What You Should See
Powered up and upload well the code, press down the button, LED light is turned on, it will not be off when release the button; But if press the button once again, LED will be turned off. It seems like your table lamp.

thumb
Open the monitor, you should be able to see how many times do you press the button.
thumb


Project 5: Relay

Overview
In this project, we will show you how to control a relay module. This relay module uses a high-quality relay. A relay is basically an electrically controlled mechanical switch. It can be used to interactive projects.

Component Required:

  • EASY plug control board*1
  • EASY plug Single Relay Module *1
  • RJ11 cable*1
  • USB cable*1


Component Introduction:

Keyestudio EASY plug Single Relay Module

This EASY Plug relay module uses a high-quality relay. A relay is basically an electrically controlled mechanical switch.
It is one of the most important controlled elements, which is widely used to control the lighting, communications, remote sensing, electrical and other equipments. The Relay output state by a light-emitting diode, observing the relay ON and OFF status.
It can be controlled through the digital IO port, such as lamps, motors and other high current or high voltage devices.

  • Type: Digital
  • Rated current: 10A (NO) 5A (NC)
  • Maximum switching voltage: 150VAC 24VDC
  • Digital interface
  • Control signal: TTL level
  • Rated load: 8A 150VAC (NO) 10A 24VDC (NO); 5A 250VAC (NO/NC) 5A 24VDC (NO/NC)
  • Maximum switching power: AC1200VA DC240W (NO); AC625VA DC120W (NC)
  • Contact action time: 10ms


Connect It Up
Connect the EASY Plug Single Relay module to control board using an RJ11 cable.
thumb

Upload the Code
Below is an example code.

thumb


What You Should See
Done uploading the code, you should be able to hear the relay contacts click. When the relay is off, the COM (common) terminal block will be connected to the NC (Normally Closed) terminal block.
When the relay is on, the COM (common) terminal block will be connected to the NO (Normally Open) terminal block.
thumb

thumb


Project 6: Crash

Overview
We use a crash sensor to detect whether happen collision or not. When an object crashes the metal switch of the sensor, it will output LOW level signal. When the switch is disconnected, it will keep HIGH level.

Component Required:

  • EASY plug control board*1
  • EASY plug Crash Sensor *1
  • EASY plug LED Module *1
  • EASY plug Relay Module *1
  • RJ11 cable*1
  • USB cable*1

Component Introduction:

Keyestudio EASY plug Crash Sensor

Crash sensor, also known as snap-action switch, is an electric switch that is actuated by very little physical force.
It is a digital on-off input module necessary for elementary electronic.
By programming, it can be used for the light, sound device, key function of LCD display, 3D Printer position feedback, or other devices.

  • Onboard status indicator LED
  • M3 mounting hole, convenient for fixation on other devices.
  • If collision happened, outputs LOW level signal; no collision, outputs HIGH level signal.


Connect It Up
Connect the EASY Plug Crash sensor to control board using an RJ11 cable.
thumb


Upload the Code
Below is an example code.
thumb

thumb

What You Should See
When an object crashes the metal switch of the sensor, the LED is turned off. If no crash happened, LED is turned on.
thumb

thumb

You should be able to see the value printing on the monitor.
thumb


Extension Experiment:

Switch Controlling Relay
Hookup Guide
Connect the EASY Plug Crash sensor and relay module to control board using an RJ11 cable.
thumb

Upload the Code
Below is an example code.
thumb


What You Should See

thumb
If crash the limit switch, the LED on the relay module is turned on.
thumb


Troubleshooting:'

  • Program Not Uploading?

This happens sometimes, the most likely case is a confused Board and serial port, you should firstly select your proper board and port.
If it doesn’t, make sure you have assembled the circuit correctly and verified and uploaded the code to your board.


Project 7: I Feel Pressure

Overview
How to measure the outside force? Use a pressure sensor.

Component Required:

  • EASY plug control board*1
  • EASY plug thin-film pressure sensor *1
  • EASY plug LED Module *1
  • RJ11 cable*1
  • USB cable*1


Component Introduction:

EASY plug Thin-film Pressure Sensor

This EASY plug pressure sensor adopts the flexible Nano pressure-sensitive material with an ultra-thin film pad.
It has the functions of water-proof and pressure detection.
The force sensors are ultra-thin and flexible printed circuits, which can be easily integrated into force measurement applications.

The harder you press, the lower the sensor's resistance.
When the sensor detects the outside pressure, the resistance of sensor will make a change. So we can use the circuit to convert the pressure signal that senses pressure change into the corresponding electric signal output.
In this way, we can know the conditions of pressure changes by detecting the signal changes.
You can connect the sensor to EASY plug Control board for communication using only a RJ11 cable.

  • Working Voltage: DC 3.3V—5V
  • Range: 0-0.5KG
  • Thickness: <0.25mm
  • Response Point: <20g
  • Repeatability: <±5.8%(50% load)
  • Accuracy: ±2.5%(85% range interval)
  • Durability: >100 thousand times
  • Initial Resistance: >100MΩ (no load)
  • Response Time: <1ms
  • Recovery Time: <15ms
  • Working Temperature: -20℃ to 60℃


Connect It Up
Connect the EASY Plug pressure sensor to control board using an RJ11 cable.
thumb


Upload the Code

thumb


What You Should See

thumb
After uploading the code, open the serial monitor, and set the baud rate to 9600. When tightly press the sensor, you should see the value become larger. So the sensor works normally.

thumb



Extension Experiment

Pressure Controlling LED
Hookup Guide
Connect the EASY Plug pressure sensor and LED module to control board using RJ11 cables.
thumb

Upload the Code
Below is an example code.
thumb


What You Should See
After uploading the code, when tightly press the sensor with your finger, you should see the brightness of LED will change with the pressure intensity.
thumb

thumb



Project 8: Magnetic Field

Overview
This project will tell you how to detect whether there is a magnetic field nearby or not ? Use a reed switch module.


Component Required:

  • EASY plug control board*1
  • EASY plug Reed Switch Module *1
  • EASY plug LED Module *1
  • RJ11 cable*1
  • USB cable*1


Component Introduction:

Keyestudio EASY plug Reed Switch Module

This is a small device called a reed switch on the module.
When the device is exposed to a magnetic field, the two ferrous materials inside the switch pull together and the switch closes.
When the magnetic field is removed, the reeds separate and the switch opens. This makes for a great non-contact switch.
You can mount reed switch on the door for alarming purpose or as switches.

  • Interface: Easy plug
  • Working voltage: DC 3.3V-5V
  • Working current: ≥20mA
  • Working temperature: -10℃ to+50℃
  • Detection distance: ≤10mm


Connect It Up
Connect the EASY Plug Reed switch module and LED module to control board using RJ11 cables.
thumb


Upload the Code
Below is an example code.
thumb


What You Should See
If you put a magnetic bead close to the reed module, once the reed module detects the magnetic field, LED will turn on.
thumb

thumb


Project 9: 4-digit LED display

Overview
When you watch a ball game, you might often see the countdown.
Here comes an EASY Plug 4-digit 0.36’’ LED display! Through this project, you will learn how to control the 4-digit LED display show the time counting.
Component Required:

  • EASY plug control board*1
  • EASY plug 4-digit LED display*1
  • EASY plug button module*1
  • RJ11 cable*1
  • USB cable*1


Component Introduction

Keyestudio EASY plug 4-Digit LED Display

This is a 4-digit 0.36’’ Common Anode LED display module, a 12-pin display module with score points.
The driver chip used in the matrices is TM1637, using only two signal cables to make the microcontroller control the 4-digit LED display.
The four pins of LED display are GND、VCC、DIO、CLK. (GND is ground, VCC is for power supply, DIO is data IO pin, CLK is clock signal pin.)
The module pins are extended into Registered jack, so you can easily connect it to EASY Plug control board using a RJ11 cable.

  • Operating Voltage: DC5V
  • Operating Temperature Range: -40℃~+85℃


Connect It Up
Connect the EASY Plug 4-digit LED display module and button module to control board using RJ11 cables.
thumb


Upload the Code
Below is an example code.
thumb

thumb


What You Should See
After uploading the code, you should see the 4-digit LED display show the number jumping.
On the left side, show 555; after one second, show 0125 on the right side; after one second, show 125; then after one second, the display brightness is 1, becoming rather darker. One second later, the display brightness is 7, becoming rather brighter.
After one second again, show the 12:89; then one second later, do not show the colon. After one second, the LED display is off; and one second later, start to repeat the display again.
thumb

thumb


Troubleshooting:'

  • Compiling Fails ?

This happens sometimes, the most likely case is a library file not added. You should be sure all the libraries under the KS_EasyPulg are added to the libraries directory of Arduino-1.8.5. Shown below.

thumb

thumb

thumb


  • Program Not Uploading?

This happens sometimes, the most likely case is a confused Board and serial port, you should firstly select your proper board and port.

thumb


Extension Experiment 1:

Time Counting
Hookup Guide
Connect the EASY Plug 4-digit LED display module to control board using an RJ11 cable.
thumb

Test Code
Below is an example code.
thumb


What You Should See

thumb

The 4-digit LED display starts to show the time counting. Seconds on the right, minutes on the left, and return to zero after 60 minutes.
thumb


Extension Experiment 2


Counting And Reset
Hookup Guide
Connect the EASY Plug 4-digit LED display module and button module to control board using RJ11 cables.
thumb

Test Code
Below is an example code.
thumb

thumb

thumb


What You Should See
The 4-digit LED display starts to show the time counting. If press the button, it will reset the counting.



Project 10: Photo Interrupter

Overview
In this project, you will learn about how to use a photo interrupter module to turn on the LED and print the analog value on the monitor.


Component Required:

  • EASY plug control board*1
  • EASY plug Photo Interrupter Module *1
  • EASY plug LED Module *1
  • EASY plug 4-digit LED Display Module *1
  • RJ11 cable*1
  • USB cable*1


Component Introduction:

Keyestudio EASY plug Photo Interrupter Module

This is a high performance EASY Plug photo interrupter module.
It integrates a photo-interrupter, which belongs to an optical switch of a photo-interrupting photoelectric switch.

The upright part on the module combines an infrared light emitting diode and shielded infrared detector.
By emitting a beam of infrared light from one end to another end, the sensor can detect an object when it passes through the beam.
Useful for many applications such as optical limit switches, pellet dispensing, general object detection, etc.
Note: this module needs to be used together with EASY plug control board.

  • Supply Voltage: 3.3V to 5V
  • Interface: Digital


Connect It Up
Connect the EASY Plug Photo Interrupter module and LED module to control board using RJ11 cables.
thumb

Upload the Code
Below is an example code.
thumb


What You Should See
Done uploading the code, powered on, if pick up a piece of paper to cover the light on the groove part of module, you should see the LED is turned on. If no interruption, the LED is off.

thumb

thumb


Extension Experiment

Adding 4-digit LED Display
Hookup Guide
Connect the EASY Plug crash sensor, 4-digit LED display and LED module to control board using RJ11 cables.

thumb


Upload the Code
Below is an example code.

thumb

thumb


What You Should See

thumb
Done uploading the code, if pick up a piece of paper to cover the light on the groove part, the LED is turned on. If no interruption, the LED is off.
thumb
You should be able to see the number of covering the light is showed on the 4-digit LED display, or on the monitor.
thumb


Project 11: Hall Magnetic Detection

Overview
What's the best way to detect the magnet? Use another magnet. But it's not sensitive enough. You have to feel it by yourself.
Here you can try to use a hall sensor. It has the characteristics of high sensitivity, fast response, good temperature performance and high reliability.
Component Required:

  • EASY plug control board*1
  • EASY plug Hall Magnetic Sensor*1
  • EASY plug LED Module *1
  • EASY plug 4-digit LED Display Module *1
  • RJ11 cable*1
  • USB cable*1


Component Introduction:

Keyestudio EASY plug Hall Magnetic Sensor

The Hall sensor is based on Hall Effect.
It can detect whether there is a magnetic object nearby or not. And it correctly tells you through digital output.
This sensor uses the SFE Reed Switch - Magnetic Field Sensor. It can sense the magnetic materials within a detection range up to 75px.
The detection range and the strength of magnetic field are proportional.
It is useful for non-contact/waterproof type switches, position sensors, rotary/shaft encoders.

  • Sensing magnetic materials
  • Detection range: up to 75px
  • Output: Digital ON/OFF
  • Detection range and magnetic field strength are proportional


Connect It Up
Connect the EASY Plug Hall Magnetic Sensor and LED module to control board using RJ11 cables.
thumb


Upload the Code
Below is an example code.
thumb


What You Should See

thumb
When magnetic beads are approaching to the sensor, the LED will be turned on. Otherwise, the LED is off.
thumb

Little Knowledge:'
If you want to change another way, that is, once magnetic field is detected by sensor, LED is turned off; if no detecting magnetic field, LED is on.
Just need to change the LED state ON or OFF in the code, shown below.

thumb


Extension Experiment

Adding 4-digit LED Display

Hookup Guide
Connect the EASY Plug hall sensor, 4-digit LED display and red LED module to control board using RJ11 cables.
thumb


Upload the Code
Below is an example code.
thumb

thumb

What You Should See
When magnetic beads are approaching to the sensor, the LED will be turned on. Otherwise, the LED is off.
How many times the magnet approaches to the sensor? You should be able to see the result showed on the 4-digit LED display or serial monitor.

thumb

thumb



Project 12: Analog Temperature

Overview
In this circuit, you will learn how to integrate the temperature sensor with your EASY Plug control board, and display the analog temperature on the serial monitor.


Component Required

  • EASY plug control board*1
  • EASY plug LM35 Temperature Sensor *1
  • EASY plug LED module *1
  • EASY plug 4-digit LED Display Module*1
  • RJ11 cable*1
  • USB cable*1


Component Introduction

Keyestudio EASY plug LM35 Temperature Sensor

It is based on semiconductor LM35 temperature sensor. A temperature sensor is exactly what it sounds like - a sensor used to measure ambient temperature.
It is effective in the range between 0 degree Celsius and 100 degree Celsius. Sensitivity is 10mV per degree Celsius. The output voltage is proportional to the temperature.

  • Power supply: 5V
  • Sensitivity: 10mV per degree Celsius
  • Function range: 0℃ to 100℃


Connect It Up
Connect the EASY Plug LM35 temperature to control board using an RJ11 cable.
thumb


Upload the Code
Below is an example code.
thumb


What You Should See

thumb
Done uploading the code, open the serial monitor and set the baud rate to 9600, you should see the analog temperature value.
thumb

Extension Experiment 1

Temperature Controlled Light
Complete the above experiment, you can get the analog temp. value. Want to try some different experiments.
For instance, when the temperature reaches the setting value, turn on an LED. Let’s get started right now!

Hookup Guide
Connect the EASY Plug LM35 sensor and LED module to control board using RJ11 cables.
thumb

Example Code
Below is an example code.
thumb


What You Should See
Done uploading the code, when the temperature detected by LM35 sensor is greater than 19℃, external LED will be turned on.
thumb


Little Knowledge:'
As we all known, different regions might exists different climate. So if the setting temp. value is too low or too high, cannot turn on the LED, you can change the value in the code shown below.

thumb


Extension Experiment 2

Adding 4-digit LED Display
Next, how about adding a 4-digit LED display to show the temperature value. Let’s get started right now!


Hookup Guide
Connect the EASY Plug LM35 sensor and 4-digit LED module to control board using RJ11 cables.
thumb


Example Code
Below is an example code.

thumb


What You Should See

thumb
Upload success, you should be able to see the temperature value is showed on the 4-digit LED display.
thumb


Project 13: Tilt Switch

Overview
This lesson we are going to test the tilt sensor. Simply connect to EASY Plug control board to make amazing interactive projects.


Component Required:

  • EASY plug control board*1
  • EASY plug Tilt Sensor Module *1
  • EASY plug LED Module *2
  • RJ11 cable*1
  • USB cable*1


Component Introduction:

Keyestudio EASY plug Tilt Sensor Module

The tilt-switch twig is the equivalent of a button, and is used as a digital input. Inside the tilt switch is a ball that make contact with the pins when the case is upright. Tilt the case over and the balls don't touch, thus not making a connection. When the switch is level it is open, and when tilted, the switch closes.
It can be used for orientation detection, alarm device or others.
Here is the principle of tilt sensor to illustrate how it works:

thumb

  • Interface: Easy plug
  • Supply Voltage: 3.3V to 5V
  • Sensor type: Digital


Connect It Up
Connect the EASY Plug Tilt sensor and LED module to control board using RJ11 cables.
thumb

Upload the Code

Below is an example code.
thumb


What You Should See
Done uploading the code, if tilt the sensor, you should see the led state ON or OFF.
thumb

thumb

thumb


Extension Experiment

Controlling Two Lights
Next, how to use tilt sensor to control two lights on and off. Let’s get started right now!

Hookup Guide
Connect the EASY Plug tilt sensor and two LED modules to control board using an RJ11 cable.
thumb

Upload the Code
Below is an example code.

thumb


What You Should See

thumb
Upload success, if tilt the sensor to one side, you should see one led is turned on; if tilt toward another side, another led is turn on.
thumb

thumb


Project 14: LCD Display

Overview
In this project, you will learn how to use an LCD module. An LCD, or liquid crystal display, is a simple screen that can display commands, bits of information, or readings from your sensor - all depending on how you program your board.


Component Required

  • EASY plug control board*1
  • EASY plug 1602 LCD Module *1
  • EASY plug Tilt sensor *1
  • EASY plug LED Module *2
  • RJ11 cable*1
  • USB cable*1

Component Introduction

Keyestudio EASY plug 1602 LCD Module

This is a basic 16 character by 2 line LCD display with white text on blue background.
It comes with EASY Plug connector, you can use one line for simple connection.

  • Compatible with Arduino LiquidCrystal Library
  • White text on blue background
  • 16 characters wide, 2 rows
  • I2C Address: 0x27
  • Back Light: Blue
  • Text Color: White
  • Supply Voltage: 5V
  • Adjusting contrast by a potentiometer


Connect It Up
Connect the EASY Plug 1602 LCD module to control board using an RJ11 cable.
thumb


Upload the Code
Below is an example code.

thumb


What You Should See

thumb
Initially, you should see the words “hello, word!” and “keyestudio!” pop up on your LCD.
Remember you can adjust the contrast using the potentiometer on the module back if you can’t make out the words clearly.

thumb

Little Knowledge:'

  • If you want to change the characters showed on the LCD screen, you can modify it in the code shown below.


thumb

  • Remember you can adjust the contrast by rotating a blue potentiometer on the LCD back if you can’t make out the words clearly.


thumb


Extension Experiment

Tilt Controlled Counting
Next, let’s get started with a little bit more complicated experiment.
For instance, use a tilt sensor to control the 1602 LCD show the counting. Let’s get started right now!

Hookup Guide
Connect the EASY Plug LCD module, two LED modules and a tilt sensor to control board using RJ11 cables.
thumb

Test Code
Below is an example code.
thumb

What You Should See
Done uploading the code, if tilt the sensor, the red LED is turned on, and you should see the number showed on the first line of 1602 LCD will plus 1 per second, and ++ is displayed on the second line.

thumb

If tilt the sensor to another side, the white LED is turned on, and you should see the number showed on the first line of 1602 LCD will subtract 1, and -- is displayed on the second line.

thumb

Little Knowledge:'

  • Remember you can adjust the contrast by rotating a blue potentiometer on the LCD back if you can’t make out the words clearly.


thumb

  • But if you want to show other characters, you can also change it in the code shown below.


thumb



Project 15: Sound

Overview
When we walk through the corridor to make a sound, the corridor light will automatically light up, after that, quiet down, the lights are off. Why? Actually inside the lighting circuit, it has installed a sound sensor. When detects the sound, light is turned on, or else LED off.
In this lesson, we will connect a sound sensor to EASY Plug control board, detecting the outside sound and printing out the analog value.

Component Required

  • EASY plug control board*1
  • EASY plug Analog Sound Sensor *1
  • EASY plug 1602 LCD Module *1
  • RJ11 cable*1
  • USB cable*1
Keyestudio EASY plug Analog Sound Sensor

Component Introduction
It is typically used in detecting the loudness in ambient environment. You can use it to make interactive circuits such as a voice-operated switch.
The sound sensitivity can be adjusted by the potentiometer.
The sensor comes with a fixed hole, easy for fixation on other devices.

  • Sensor type: Analog
  • Supply Voltage: 3.3V to 5V
  • Operating current:<10mA
  • Output signal:analog signal


Connect It Up
Connect the EASY Plug analog sound sensor to control board using an RJ11 cable.
thumb


Upload the Code
Below is an example code.
thumb

What You Should See
After uploading the code, open the serial monitor and set the baud rate to 9600, you should see the analog value is showed on the monitor.
thumb

thumb

Extension Experiment

Adding LCD Display

Connect It Up
Connect the EASY Plug sound sensor and LCD module to control board using RJ11 cables.
thumb


Upload the Code
Below is an example code.
thumb

What You Should See

thumb
Upload the code successfully, when the sensor detects the outside sound, the LCD screen will show the sound volume, and its unit is decibel (dB).
thumb


Little Knowledge:'

  • Remember you can adjust the contrast by rotating a blue potentiometer on the LCD back if you can’t make out the words clearly.


thumb


Project 16: It Rains

Overview
This experiment we are going to detect the water drop using keyestudio EASY Plug steam sensor. It is an analog sensor that can be used to make simple rain detectors and level switches.

Component Required

  • EASY plug control board*1
  • EASY plug Steam Sensor *1
  • EASY plug 1602 LCD Module *1
  • RJ11 cable*1
  • USB cable*1
Keyestudio EASY plug Steam Sensor

Component Introduction
Vapor Sensor is an analog sensor and can make a simple rainwater detector and liquid level switch. When humidity on the surface of the sensor goes up, the output voltage will increase.
Warning:' The connector is not waterproof, please be careful not to put the connector directly in water.
The module can be connected to the analog input interface with only one line, which is very easy and convenient.

  • Working Voltage: 5V
  • Working Current: <20mA
  • Working Temperature: -10℃~+70℃
  • Interface Type: Analog Signal Output


Connect It Up
Connect the EASY Plug Steam Sensor to control board using an RJ11 cable.
thumb

Upload the Code
Below is an example code.
thumb


What You Should See
When detect the different degree of humidity, the sensor outputs different value. If the sensor’s sensing area detects a water drop, the analog value will be displayed on monitor window.
thumb

thumb

Extension Experiment

Adding LCD Display

Hookup Guide
Connect the EASY Plug steam sensor and LCD module to control board using RJ11 cables.
thumb


Test Code
Below is an example code.
thumb


What You Should See

thumb
Upload the code successfully, if the sensor detects a drop of water, the data will be showed on the LCD screen.
thumb

Little Knowledge:'

  • Remember you can adjust the contrast by rotating a blue potentiometer on the LCD back if you can’t make out the words clearly.


thumb


Project 17: Alcohol in the Air

Overview
In this project, you will learn how to use the alcohol sensor and control board to detect the alcohol content in the air.

Component Required

  • EASY plug control board*1
  • EASY plug Alcohol Sensor *1
  • EASY plug 1602 LCD Module *1
  • RJ11 cable*1
  • USB cable*1


Component Introduction

Keyestudio EASY plug Analog Alcohol Sensor


This analog gas sensor - MQ3 is suitable for detecting alcohol. It can be used in a Breath analyzer. Also it has high sensitivity to alcohol and low sensitivity to Benzine.
The sensitivity can be adjusted by a blue potentiometer on the sensor.

  • Power supply: 5V
  • Sensor type: Digital and Analog
  • Quick response and High sensitivity
  • Simple drive circuit
  • Stable and long service life


Connect It Up
Connect the EASY Plug analog alcohol sensor to control board using an RJ11 cable
thumb


Upload the Code

thumb


What You Should See
Done uploading the code, open the serial monitor and set the baud rate to 9600. If the sensor detects the alcohol in the air, you should see the value change.
thumb

thumb

Extension Experiment

Adding LCD Display

Hookup Guide
Connect the EASY Plug alcohol sensor and LCD module to control board using RJ11 cables.

thumb


Test Code
Below is an example code.
thumb

What You Should See

thumb
Upload success, you should be able to see the alcohol value is showed on the LCD screen.
thumb
If you can’t see the data clearly, you should rotate the potentiometer on the back of LCD display to adjust the backlight.
thumb



Project 18: Water Level

Overview
This lesson we are going to detect the water level using keyestudio water level sensor, showing you the value on the monitor or LCD screen.

Component Required

  • EASY plug control board*1
  • EASY plug Water Level Sensor *1
  • EASY plug 1602 LCD Module *1
  • RJ11 cable*1
  • USB cable*1


Component Introduction

Keyestudio EASY plug Water Sensor

This sensor is easy-to-use, portable and particularly designed to identify and detect water level and water drop.
It can measure the volume of water drop and water quantity through an array of traces of exposed parallel line.
This sensor is small and equipped with the following features:
i) smooth conversion between water quantity and analog quantity;
ii) strong flexibility, outputting analog value;
iii) low power consumption and high sensitivity;
iv) directly connected to microprocessor or other logic circuits, suitable for a variety of development boards and controllers such as Arduino controller, STC single-chip microcomputer, AVR single-chip microcomputer, etc.


Specifications

  • Operating voltage: DC5V
  • Operating current: <20mA
  • Sensor type: Analog
  • Detection area: 40mm x16mm
  • Production process: FR4 double-side tinned
  • Operating temperature: 10%~90% without condensation


Connect It Up
Connect the EASY Plug water level sensor to control board using an RJ11 cable.
thumb


Upload the Code
Below is an example code.
thumb

What You Should See

thumb
Hook it up and upload well the code, you will see the led light on the water sensor light up, then open the serial monitor, you will see the analog value.
When place the sensing area of sensor into the water, you can see the data change. The deeper the sensor’s sensing area into water, the greater the value.
thumb

thumb


Extension Experiment

Adding LCD Display
Hookup Guide
Connect the EASY Plug water level sensor and LED module to control board using an RJ11 cable.

thumb


Test Code
Below is an example code.
thumb


What You Should See

thumb
Upload success, you should be able to see the analog value is showed on the LCD screen.
thumb


Little Knowledge:'

  • Remember you can adjust the contrast by rotating a blue potentiometer on the LCD back if you can’t make out the words clearly.


thumb


Project 19: Potentiometer

Overview
In this circuit you’ll work with a potentiometer sensor. You will learn how to simply test this potentiometer sensor to get the analog value.

Component Required

  • EASY plug control board*1
  • EASY plug Potentiometer Sensor *1
  • EASY plug 1602 LCD Module *1
  • EASY plug LED Module *1
  • RJ11 cable*1
  • USB cable*1


Component Introduction

Keyestudio EASY plug Analog Rotation Sensor

The sensor is based on a potentiometer. A potentiometer is also known as a variable resistor. It is a perfect demonstration of a variable voltage divider circuit. Its voltage can be subdivided into 1023, easy to be connected to Arduino with our sensor shield.
Combined with other sensors, you are able to make interesting projects by reading the analog value from the IO port.

  • Interface: Easy plug
  • Supply Voltage: 3.3V to 5V
  • Sensor type: Analog


Connect It Up
Connect the EASY Plug potentiometer sensor to control board using an RJ11 cable.
thumb


Upload the Code
Below is an example code.
thumb


What You Should See
After uploading the code, open the serial monitor and set the baud rate to 9600, you should see the analog value is showed on the monitor.
thumb
If rotate the potentiometer, the printed analog value will change within the range of 0-1023.
thumb


Extension Experiment

Controlling Light Brightness
Complete the above experiment, want to try a different experiment?
Next, you will learn how to display the potentiometer value on the 1602 LCD screen and to control the brightness of LED using a potentiometer sensor.
Let’s get started right now!


Hookup Guide
Connect the EASY Plug potentiometer sensor, a red LED module and 1602 LCD module to control board using RJ11 cables.
thumb

Test Code
Below is an example code.

thumb

What You Should See
After uploading the code, rotate the potentiometer knob, you can see the converted value by potentiometer within 0~255 on the 1602 LCD screen, controlling the brightness of LED module.
thumb


Little Knowledge:'

  • Remember you can adjust the contrast by rotating a blue potentiometer on the LCD back if you can’t make out the words clearly.


thumb


Project 20: Temperature and Humidity

Overview
How to test the temperature and humidity in the current environment? Use a DHT11 sensor. Simply connect to the EASY Plug control board.


Component Required

  • EASY plug control board*1
  • EASY plug DHT11 Sensor *1
  • EASY plug 1602 LCD module *1
  • RJ11 cable*1
  • USB cable*1


Component Introduction

Keyestudio EASY plug DHT11 Temperature and Humidity Sensor


The DHT11 is a basic, ultra low-cost digital temperature and humidity sensor.
It uses a capacitive humidity sensor and a thermistor to measure the surrounding air, and provides a pre-calibrated digital signal output.
This DHT11 sensor has fast response, anti-interference ability, excellent reliability and long-term stability.

  • Supply Voltage: 5V
  • Relative Humidity and temperature measurement
  • Good for 20-90% humidity readings with 5% accuracy
  • Good for 0-50°C temperature readings ±2°C accuracy
  • Interface: Digital
  • Low Cost


Connect It Up
Connect the EASY Plug temperature and humidity module to control board using an RJ11 cable.
thumb


Upload the Code
Below is an example code.
thumb


What You Should See
Open the Serial monitor, you should be able to see the temperature and humidity data.

thumb

Little Knowledge:'

  • If the data is scrolling very fast, you can’t make out the data clearly, so you can modify the Delay time in the code to check it easily.


thumb


Extension Experiment

Make a Hygrothermograph

Hookup Guide
Connect the EASY Plug DHT11 sensor and 1602 LCD module to control board using RJ11 cables.
thumb


Test Code
Below is an example code.
thumb


What You Should See

thumb
Upload success, you should be able to see the temperature and humidity data are showed on the LCD screen.
thumb


Project 21: Matrix Display

Overview
This lesson you will learn how to use an 8x8 LED matrix to show different images.

Component Required

  • EASY plug control board*1
  • EASY plug I2C 8x8 LED Matrix *1
  • EASY plug button module*1
  • RJ11 cable*1
  • USB cable*1


Component Introduction

thumb

What's better than a single LED? Lots of LEDs! A fun way to make a small display is to use an 8x8 matrix.
This module uses HT16K33 chip to drive an 8x8 dot matrix. Just need to use the I2C communication port of microcontroller to control the dot matrix, which can save more port resources of microcontroller.
The four pin of this module is integrated into a crystal plug. All you need to do is connect the module to control board for communication using an RJ11 cable.

  • Interface: Easy plug
  • Supply voltage: 4.5V-5.5V


Connect It Up
Connect the EASY Plug 8x8 LED Matrix module to control board using an RJ11 cable.
thumb


Upload the Code
Below is an example code.
thumb


What You Should See
Upload the code successfully, it will light up a dot light on the matrix.
thumb


Extension Experiment 1

Showing 0~5
You can upload the code below to show the number 0~5.
thumb

thumb

thumb


What You Should See
Upload the code successfully, the matrix will show the number from 0 to 5.
thumb

thumb

thumb

Extension Experiment 2

Button Controlled Heart

Hookup Guide
Connect the EASY Plug 8x8 LED Matrix module and button module to control board using RJ11 cables.
thumb


Test Code
Below is an example code.

thumb

thumb


What You Should See

thumb
Upload the code successfully, press the button, you can control the matrix show a big heart image or a small one. It seems like a beating heart.
thumb

thumb


Project 22: Acceleration

Overview
This lesson you will learn about how to use a Triple Axis Acceleration module ADXL345 for tilt sensing.


Component Required

  • EASY plug control board*1
  • EASY plug ADXL345 Acceleration Module *1
  • EASY plug LED module *3
  • RJ11 cable*1
  • USB cable*1


Component Introduction

Keyestudio EASY plug ADXL345 Acceleration Module

The ADXL345 module is a low power, 3-axis MEMS accelerometer with high resolution (13-bit) and measurement at up to ±16g (gravitational force).
Digital output data is formatted as 16-bit twos complement, and is accessible through either a SPI or I2C digital interface.
The ADXL345 is well suited to measures the static acceleration of gravity in tilt-sensing applications, as well as dynamic acceleration resulting from motion or shock.

  • Working Voltage: 2.0-3.6V
  • Ultra Low Power @2.5v: 40uA /working mode; 0.1uA / standby mode
  • Communication interface: I2C / SPI
  • Tap/Double Tap Detection ; Free-Fall Detection


Connect It Up
Connect the EASY Plug ADXL345 Acceleration module to control board using an RJ11 cable.
thumb

Upload the Code
Upload the code to your board to check the 3-axis acceleration data and the module's tilt information.
thumb


What You Should See
Open the Serial monitor to see the 3-axis acceleration data. See changes as you sway the Accelerometer.
thumb

Little Knowledge:'
If you think the monitor’s result is too fast to see the data clearly, you can drag a Delay block to add into the source code. Shown below.
After that, upload the code again and open the monitor, you should be able to see the display data clearly.

thumb

Extension Experiment

Controlling Three LEDs
Hookup Guide
Connect the EASY Plug ADXL345 Acceleration module and three LED modules to control board using RJ11 cables.
thumb


Test Code
Upload the test code below to your board to check the 3-axis acceleration data and the module's tilt information.
thumb


What You Should See

thumb
Upload success, open the serial monitor, it prints out the value of X,Y,Z axis. Each axis controls a light. If the measured value is greater than 200, LED lights up.
thumb

thumb

thumb



Resources

  • Download all the information here:

https://drive.google.com/open?id=1vwi83EYa3dYORHdme2KI57MHu38WbaBA

  • User Guide Download:

https://drive.google.com/open?id=1caqF-mPWz0KVEl8TyAAsUt3krOnvZCrO

  • Download the Mixly Software:

https://drive.google.com/open?id=19cq--ZXvKlJ7zv_VghGk7b6IV6aBMSzR

  • Mixly Code for All Projects:

https://drive.google.com/open?id=1lTg8q_mYh1ebc8TV766oea4F_RLP16_P

  • Download the KS_EasyPulg Library:

https://drive.google.com/open?id=1-DB-jrtbR3HbdRIohXbN-UK0nm5MwjxR

  • Arduino Software:

https://www.arduino.cc/en/Main/OldSoftwareReleases#1.5.x


Our Tutorial

From the tutorial, you will learn all the basic information about EASY Plug controller board, sensor module, very easy to play and and to make interactive projects. Enjoy your time!
Well, it's just the beginning of programming journey. There are more and more awesome projects for you to explore.
Furthermore, our KEYESTUDIO research and development team will continue to explore on this path, walking you through the basics up to complex projects.
Hope that you can enjoy our works!


About keyestudio

Located in Shenzhen, the Silicon Valley of China, KEYES DIY ROBOT CO.,LTD is a thriving technology company dedicated to open-source hardware research & development, production and marketing.
Keyestudio is a best-selling brand owned by KEYES Corporation, our product lines range from Arduino boards, shields, sensor modules, Raspberry Pi, micro:bit extension boards and smart car to complete starter kits designed for customers of any level to learn programming knowledge.
All of our products comply with international quality standards and are greatly appreciated in a variety of different markets throughout the world.

For more details of our products, you can check it from the links below.
Official website: http://www.keyestudio.com/
US Amazon storefront: http://www.amazon.com/shops/A26TCVWBQE4D9T
CA Amazon storefront: http://www.amazon.ca/shops/A26TCVWBQE4D9T
UK Amazon storefront:http://www.amazon.co.uk/shops/A39F7KX4U3W9JH
DE Amazon storefront: http://www.amazon.de/shops/A39F7KX4U3W9JH
FR Amazon storefront: http://www.amazon.de/shops/A39F7KX4U3W9JH
ES Amazon storefront: http://www.amazon.de/shops/A39F7KX4U3W9JH
IT Amazon storefront: http://www.amazon.de/shops/A39F7KX4U3W9JH
US Amazon storefront: http://www.amazon.com/shops/APU90DTITU5DG
CA Amazon storefront: http://www.amazon.ca/shops/APU90DTITU5DG
JP Amazon storefront: http://www.amazon.jp/shops/AE9VWCCXQIC6J



Customer Service

As a continuous and fast growing technology company, we keep striving our best to offer you excellent products and quality service as to meet your expectation.
We look forward to hearing from you and any of your critical comment or suggestion would be much valuable to us.
You can reach out to us by simply drop a line at [email protected]
Thank you in advance.