Template:BuildMecar Kit Setup

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

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.

• 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:

• Save and start the Pi.

Configure SSH (Optional)

• Our image has SSH enabled by default. If users are using the official buster image, they need to enable SSH by themselves.
• The opening method is as follows:
• Create a folder named SSH under the boot drive letter.

Login Raspberry Pi

With Display

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

Remote Login

• If you want to use remote login to Raspberry Pi, you need to meet the following requirements:

1. Make sure the Raspberry Pi is connected to the network, either via WLAN or a cable.
2. Make sure the Raspberry Pi and your computer are under the same router or on the same network segment.
3. Make sure that the corresponding remote login function is enabled on the Raspberry Pi.

• In addition to these requirements, if you have multiple Raspberry Pis online under the same network segment, you also need to obtain the IP address of your Raspberry Pi
• You can use some LAN IP scanning tools, here is an example of Advanced IP Scanner (if you do not have multiple Raspberry Pi online or use the mirror provided by us, you can skip this step).

1. Run Advanced IP Scanner.

2. Click the Scan button to scan the IP address in the current LAN.

3. Find all IP addresses with the word Raspberry Pi in the Manufacturer and record them.

4. Power on the device and make sure the device is connected to the network.

5. Click the Scan button again to scan the IP address in the current LAN.

6. Exclude all the IP addresses that have the word Raspberry Pi in the previously recorded Manufacturer, and the rest is your Raspberry Pi IP address.

SSH Login

• Make sure SSH is enabled, here use the SSH login command that comes with Windows.

1. Press win and R at the same time, type cmd, and enter to open the command line.
   
   
2. Input the corresponding commands, there are roughly three cases:
   
   • If you are using the image we provide, use the following command:

   ssh pi@BuildMecar

   • If you are using the original Raspberry Pi image and only one Raspberry Pi device is online, use the following command:

   ssh pi@raspberrypi

   • If you are using the original Raspberry Pi image and multiple Raspberry Pi devices are online, please use the following command:

   ssh pi@IP address

   • A method of obtaining an IP address has been described above, so I won't repeat it here.
   • Suppose you get the address 192.168.10.51, the command should be:

   ssh [email protected]

   

3. Input the password 'raspberry and Enter.

   

4. Here the SSH login was successful.

Software Setup

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

Enable UART

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 srial port hardware:

Reboot Raspberry Pi:

sudo reboot

Open the /boot/config.txt file and find the following configuration statement to enable the serial port, if not, add it at the end of the file:

enable_uart=1

Reboot to take effect.

Enable Camera

Open a terminal and run the following command:

sudo raspi-config

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

Download Demo and Install Libraries

Open a terminal and run the following commands.

cd ~
sudo apt-get install unzip -y
wget https://files.waveshare.com/upload/a/ad/BuildMecar-code.zip
unzip BuildMecar-code.zip
sudo pip3 install -r ~/BuildMecar-code/requirements.txt
wget https://files.waveshare.com/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