BuildMecar-Kit

From Waveshare Wiki
Jump to: navigation, search
BuildMecar-Kit
BuildMecar Kit

BuildMecar Kit, Smart Building Block Robot with Mecanum Wheels, 5MP Camera, Based on Raspberry Pi Build HAT
{{{name2}}}

{{{name3}}}

{{{name4}}}

{{{name5}}}

Introduction

The smart robot is always the favorite thing of electronic fans, meanwhile, building blocks can be used to make various objects in different constructions, such as vehicles, buildings, and working robots. Whatever you made, you can break it down and build another new thing by the pieces again.

The Build HAT Python library is able to control sorts of motors and sensors with an LPF2 connector, this makes it possible to build creative combinations by using the Raspberry Pi Build HAT and building blocks, so here comes our BuildMecar - a smart robot with Mecanum wheels, and built by blocks. It will move in any direction based on the Mecanum wheel technology, enabling more funny possibilities for the smart robots.

Features

  • Designed on the basis of Raspberry Pi Build HAT, easily controlling sorts of motors and sensors with an LPF2 connector
  • Built by blocks, feel free to customize your unique robot
  • High discharge coefficient Li-ion batteries, providing great power supply for the robot
  • Features Mecanum wheels, allows lateral movement, or spinning in the original place
  • Optional camera, gives your robot an eye

Notice

  • If you need to connect the camera, please first power off and then connect it, otherwise, the camera may be damaged.
  • To driver the motors, please use the Li-ion battery provided
  • Li-ion and Li-po batteries are quite unstable. They may cause fire, personal injury, or property damage if they're not properly recharged or used.
  • Do not reversely connect the polarities when recharging or discharging the battery. Do not use an inferior charger/charging panel to recharge the battery.
  • Do not mix use old batteries with new ones, avoid using batteries of different brands.
  • When buying a Lithium battery, should always make sure the battery specification is compatible with the expansion board. Choose batteries from the formal manufacturer, and ensure the batteries will work stably and safely by aging test.
  • Lithium batteries have limited cycle life, they will also deteriorate as time goes by. Should be replaced with new ones when the batteries reach their max cycle life or work over two years, whichever comes first.
  • Should be placed carefully and properly, keep it away from inflammable and explosive articles, away from children, avoid any safety accident caused by careless storage.

Connection of Motor and Wheel

Build HAT Port Motor Position Wheel Direction
PORT A right-back L
PORT B right-front R
PORT C left-back R
PORT D left-front L
Buildmecar-wheel-01.png

Write Image

  • We recommend you to use the pre-built image: BuukdMecar image
  • Please download the image and write to a Micro SD card (recommend 16G) by Win32DiskImage tool.

Configure WLAN (optional)

  • If you have a keyboard and display to connect the Raspberry Pi, you can just connect the wifi on the GUI desktop and skip this part.
  • Create a file wpa_supplicant.conf under boot directory.
Wlan-config-03.png
  • Append the following lines to the file and modify according to the actual situation
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev 
country=<The country number based on ISO 3166-1> 
update_config=1 

network={ 
 ssid="<The SSID of WIFI>" 
 psk="<The Password of WIFI>" 
}
For example:
Wlan-config-02.png
  • Save and start the Pi

Login Raspberry Pi

With Display

  • You can directly connect a display to the Pi and login the Desktop directly
Th.png

Without Display

  • If you do not have a display, you can access the Pi via SSH. It requires:
    1. The Raspberry Pi has connected to the network by WIFI or wired network
    2. The Raspberry Pi should be connected to the same network as your PC
    3. The SSH function of Pi should be enabled. (You can directly create an empty file named ssh in the boot directory)
  • Get the IP address of the Pi on your router manager page
  • Use a putty tool or the CMD tool in Windows PC
    Enter the following command to access pi
ssh [email protected]<IP address of PI>
  • For example, if the address is 192.168.10.51, it should be:
<pre>ssh [email protected]
CmdSSH-01.png
  • Input the password 'raspberry and Enter
CmdSSH-02.png

Software Setup

If you use the pre-built image, you can just skip this part.

Enable UART

If the module is set to UART mode and is connected to the UART interface of the Raspberry Pi, the UART of the Raspberry Pi also needs to be enabled accordingly. Since the Raspberry Pi serial port is used for terminal debugging by default, if you want to use the serial port, you need to modify the Raspberry Pi settings. Execute the following command to enter the Raspberry Pi configuration:

sudo raspi-config

Choose Interfacing Options -> Serial -> No -> Yes
You need to disable the login shell and enable the hardware serial

L76X GPS Module rpi serial.png

Reboot Raspberry Pi

sudo reboot

Enable Camera

Open a terminal and run the following command:

sudo raspi-config

Choose Interfacing Options -> Serial -> No -> Yes

Download Demo codes and install libraries

Open a terminal and run the following commands

cd ~
sudo apt-get install unzip -y
wget https://www.waveshare.com/w/upload/a/ad/BuildMecar-code.zip
unzip BuildMecar-code.zip
sudo pip3 install -r ~/BuildMecar-code/requirements.txt
wget https://www.waveshare.com/w/upload/9/91/Python-build-hat.zip
unzip Python-build-hat.zip
cd python-build-hat/
chmod +x ./*
sudo pip3 install . --user
sudo ./build.sh

About Examples

  • Before using the example, please make sure that you have assembled the hardware and set up the software normally.

001-MotorRotation

About hardware
  • The battery is connected to the Buildhat board
  • The Buildhat board is connected to Raspberry Pi
  • Motor is connected to the PORT A of Buildhat
Run example
  • Open a terminal and run the following command
sudo python3 ~/BuildMecar-code/001-MotorRotation/MotorRotation.py
Expected result

The motor which is connected to Buildhat PORT A will run for 1s and the stop.
Please lift the car if the motor doesn't run.

002-MotorSpeedControl

About hardware
  • The battery is connected to the Buildhat board
  • The Buildhat board is connected to Raspberry Pi
  • Motor is connected to the PORT A of Buildhat
Run example
  • Open a terminal and run the following command
sudo python3 ~/BuildMecar-code/002-MotorSpeedControl/MotorSpeedControl.py
Expected result
  1. The motor which is connected to PORT A run and speed up
  2. After touching the max speed, the motor speed down until stop
  3. The motor turns in the opposite direction, then speeds up and speeds down in a loop.

003-MultipleMotors

About hardware
  • The battery is connected to the Buildhat board
  • The Buildhat board is connected to Raspberry Pi
  • Motors are connected to the four ports of Buildhat
Run example
  • Open a terminal and run the following command
sudo python3 ~/BuildMecar-code/003-MultipleMotors/MultipleMotors.py
Expected result
  1. The motors run and speed up
  2. After touching the max speed, the motors speed down until stop
  3. The motors turn in the opposite direction, then speed up and speed down in a loop.

004-WebControl

Run example
  • Open a terminal and run the following command
sudo python3 ~/BuildMecar-code/004-WebControl/WebControl.py
Expected result
  • The IP address is printed in the terminal
WedControl-01.png
  • Open a browse and input the IP with the port 5000, for example
WedControl-02.png
  • Press the BUTTON_1 and BUTTON_2, corresponding data are printed in the Raspberry Pi terminal

005-CameraStreamer

About hardware
  • Connect the camera to the Raspberry Pi
Run example
  • Open a terminal and run the following command
sudo python3 ~/BuildMecar-code/005-CameraStreamer/CameraStreamer.py
Expected result
  • The IP address is printed in the terminal
WedControl-01.png
  • Open a browse and input the IP with the port 5000, for example
WedControl-04.png
  • The camera steam is pushed to the webpage

006-Example

About hardware
  • The BuildMecar should be assembled
  • The camera is connected to the Pi (optional)
Run example
  • The IP address is printed in the terminal
WedControl-01.png
  • Open a browse and input the IP with the port 5000, for example
WedControl-05.png
  • Click the buttons to control the BuildMecar
  • If you connect a terminal, the image will be shown on the webpage as well.

Supports

Support

If you require technical support, please go to the Support page and open a ticket.