NOTE: ALL OSOYOO PRODUCTS FOR ARDUINO ARE THIRD PARTY BOARD WHICH IS FULLY COMPATIBLE WITH ARDUINO

Contents

• Objective

• Hardware Installation

• Wire Connection

• Software Installation

• Code Explanation

• Testing

• Parts and Devices

Authorized Online Retailers

Objective

Welcome to the first lesson of OSOYOO 2WD Robot Car Starter Kit!

In this “Hello World” version lesson, we will install the most important framework of the robot car and program the car to do some simple movements. If you have passed the test movement of this lesson, it means Arduino, motor control module, motors, batteries, chassis, and wire connections between these parts are all functioning well.

As your experiments in future lessons are all based on the framework of Lesson 1, it is very essential to test the installation and sample code in this Lesson properly.

2. Connect the OSOYOO Model-X and WiFi Shield for Arduino UNO as shown below:

3. Connect OSOYOO Model-X Motor Driver Module with 2 motors

The right motor connected to K1 or K2, the left motor connected to K3 or K4 as shown below:

4. Connect OSOYOO UART Wi-Fi Shield with IR Receiver:

5. Connect OSOYOO UART Wi-Fi Shield with the tracking sensor:

Software Installation

Notice: Shut off your battery or Unplug your power adapter when upload sketch code to Arduino.

Step 1:

Install latest Arduino IDE (If you have Arduino IDE version 1.18.19, please skip this step).

Download Arduino IDE from https://www.arduino.cc/en/Main/Software?setlang=en, then install the software.

Step 2:

Download https://osoyoo.com/driver/2wd/lesson1.zip , unzip it, you will see a folder called lesson1

Step 3:

Connect UNO R3 board to PC with USB cable, open Arduino IDE, choose corresponding board/port for your project

Step 4:

Click file -> click Open -> choose code “lesson1.ino”, load the code into Arduino, and then upload the sketch to the board.

Code Explanation

Below is the interface definition between OSOYOO Model-X and arduino

Notice: ENA and ENB should connect to PWM port,   IN1/IN2 control Right Motor rotating direction,
IN3/IN4 control Left Motor rotating direction

#define speedPinR 9 // RIGHT PWM pin connect MODEL-X ENA
#define RightMotorDirPin1 12 //Right Motor direction pin 1 to MODEL-X IN1 
#define RightMotorDirPin2 11 //Right Motor direction pin 2 to MODEL-X IN2
#define speedPinL 6 // Left PWM pin connect MODEL-X ENB
#define LeftMotorDirPin1 7 //Left Motor direction pin 1 to MODEL-X IN3 
#define LeftMotorDirPin2 8 //Left Motor direction pin 1 to MODEL-X IN4 
#define SPEED 140
#define RIGHT_SPEED 140

The below functions can control the car forward, backward, stop, turn right and turn left:

void go_Advance(void) //Forward
{
digitalWrite(RightMotorDirPin1, HIGH);
digitalWrite(RightMotorDirPin2,LOW);
digitalWrite(LeftMotorDirPin1,HIGH);
digitalWrite(LeftMotorDirPin2,LOW);
analogWrite(speedPinL,SPEED);
analogWrite(speedPinR,SPEED);
}
void go_Left(int t=0) //Turn left
{
digitalWrite(RightMotorDirPin1, HIGH);
digitalWrite(RightMotorDirPin2,LOW);
digitalWrite(LeftMotorDirPin1,LOW);
digitalWrite(LeftMotorDirPin2,HIGH);
analogWrite(speedPinL,SPEED);
analogWrite(speedPinR,SPEED);
delay(t);
}
void go_Right(int t=0) //Turn right
{
digitalWrite(RightMotorDirPin1, LOW);
digitalWrite(RightMotorDirPin2,HIGH);
digitalWrite(LeftMotorDirPin1,HIGH);
digitalWrite(LeftMotorDirPin2,LOW);
analogWrite(speedPinL,SPEED);
analogWrite(speedPinR,SPEED);
delay(t);
}
void go_Back(int t=0) //Reverse
{
digitalWrite(RightMotorDirPin1, LOW);
digitalWrite(RightMotorDirPin2,HIGH);
digitalWrite(LeftMotorDirPin1,LOW);
digitalWrite(LeftMotorDirPin2,HIGH);
analogWrite(speedPinL,SPEED);
analogWrite(speedPinR,SPEED);
delay(t);
}
void stop_Stop() //Stop
{
digitalWrite(RightMotorDirPin1, LOW);
digitalWrite(RightMotorDirPin2,LOW);
digitalWrite(LeftMotorDirPin1,LOW);
digitalWrite(LeftMotorDirPin2,LOW);
}

The below functions can change motor speed, viriable speed_L can change the left motor speed, variable speed_R can control the right motor speed.

The valid range for this function parameter is 0-255

void set_Motorspeed(int speed_L,int speed_R)
{
analogWrite(speedPinL,speed_L); 
analogWrite(speedPinR,speed_R); 
}

Testing

Disconnect Arduino from PC, put 2 fully-charged 18650 battery into battery box (check the box instruction and make sure polar direction is correct, otherwise it can destroy your device and cause fire hazard). Please install your battery as per the following instruction:

Put the car on the ground, open the power switch on the battery box, open the power switch on the Wi-Fi Shield.

The car should go forward 2 seconds, then go backward 2  seconds, then left turn for 2 seconds, then right turn for 2 seconds, then stop.

If the car does not move as per above-mentioned result, you should check your wire connection, battery voltage (must over 7.2v).