How to build Freenove Robot Dog Kit for Raspberry Pi (FNK0050)
220 steps to build Freenove Robot Dog Kit for Raspberry Pi (FNK0050), with the source documents.
FNK0050 $129.99 (Freenove store, USD, 2026‑10‑31, in stock, free standard shipping, customs duties and VAT may apply); the Raspberry Pi, two 18650 cells and a charger are extra and not priced by Freenove
Buy parts
- Identify the Raspberry Pi robot shield
Check the top and bottom of the Robot Shield for Raspberry Pi.
- Check machinery parts and screws
Check the machinery parts. The included plastic bag contains M1.2*7 screws; if the self-tapping screw package is unavailable, it may be in the servo package.
- Check twelve ES08MA servos
Check the ES08MA Ⅱ servo package, quantity x12.
- Check one S90 servo
Check the S90 servo package, quantity x1.
- Check acrylic parts
Check the acrylic parts shown in the list.
- Check the LED module
Check the LED module in the list.
- Check the camera
Check the camera, quantity x1.
- Check the ultrasonic module
Check the HC-SR04 Ultrasonic Module, quantity x1.
- Check the V1.0 connection board
Check the PCB_V1.0 connection board. There are two connection-board models; remember their version numbers.
- Check the V2.0 connection board
Check the PCB_V2.0 connection board. There are two connection-board models; remember their version numbers.
- Check the ultrasonic module jumper wires
Check the F/F jumper wires for the ultrasonic module, quantity 4.
- Check the LED cable
Check the 10cm, 3Pin LED cable with the same direction.
- Check the camera cable
Check the 25cm, 15Pin camera cable with reversed direction.
- Check the FPC soft line
Check the FPC soft line, quantity x1; this cable comes only with the Raspberry Pi 5 version.
- Check the two cross screwdrivers
Check the 3mm cross screwdriver x1 and the 2mm cross screwdriver x1.
- Check the cable tidy
Check the 80cm cable tidy.
- Check the red ball
Check the red ball in the list.
- Buy Two 18650 Batteries
Buy two unprotected 3.7V 18650 lithium batteries with a continuous discharge current greater than 10A.
- Buy One Raspberry Pi
Buy one Raspberry Pi; the recommended models are Raspberry 5, 4B, or 3B+.
- Choose Raspberry Pi 3 Model B
This product supports Raspberry Pi 3 Model B, with an actual image and a CAD image provided.
- Choose Raspberry Pi 2 Model B
This product supports Raspberry Pi 2 Model B, with an actual image and a CAD image provided.
- Choose Raspberry Pi 1 Model B+
This product supports Raspberry Pi 1 Model B+, with two actual images provided.
- Choose Raspberry Pi 3 Model A+
This product supports Raspberry Pi 3 Model A+, with an actual image and a CAD image provided.
- Choose Raspberry Pi 1 Model A+
This product supports Raspberry Pi 1 Model A+, with two actual images provided.
- Choose Raspberry Pi Zero W
This product supports Raspberry Pi Zero W, with an actual image and a CAD image provided.
- Choose Raspberry Pi Zero
This product supports Raspberry Pi Zero, with an actual image and a CAD image provided.
- Select Compatible Optional Components
Choose optional components according to the Raspberry Pi model being used.
- Gather Monitor Accessories
If using an independent monitor, mouse, and keyboard, gather the required accessories listed for the selected Raspberry Pi model. Pi Zero and Pi Zero W also need their corresponding additional accessories.
- Gather Remote Desktop Accessories
Gather the accessories required for remote desktop use according to the Raspberry Pi model being used.
- Prepare Two 18650 Batteries
Prepare two 18650 lithium batteries without protection boards and a continuous discharge current greater than 10A.
- Prepare a Raspberry Pi
Prepare one Raspberry Pi; the recommended models are Raspberry 5, 4B, or 3B+.
- Match power to the Raspberry Pi model
Choose a recommended power supply for the Raspberry Pi model: Pi 5 uses 5.0A, Pi 4B and Pi 400 use 3.0A, Pi 3 models use 2.5A, Pi 2B uses 1.8A, Zero W uses 1.2A, and Zero 2 W uses 2A. A Pi 5 connected to a 5A, +5V (25W) supply can provide 1.6A to downstream USB peripherals; other compatible supplies limit this to 600mA.
- Read the Battery Guide
First unzip the downloaded project files, then read About_Battery.pdf in the unzipped folder.
- Download and Unzip Project Files
If the project ZIP file has not been downloaded, download and unzip it using the GitHub link provided on the page.
- Purchase the Robot Dog Kit
Visit the Freenove store page to purchase the robot dog kit.
Assemble
- Keep Batteries Correctly Oriented
Do not reverse the batteries while assembling or using the robot, or the board may be damaged.
- Take Out Twelve Servo Disk Arms
Take 12 disk servo arms out of the servo packages.
- Select the Wider Hole Pairs
The disk servo arm has four pairs of opposite holes with different distances between each pair. Use the two pairs with the longer distance.
- Prepare M1.2*7 Self-Tapping Screws
The M1.2*7 screws are in the following plastic bag. If a package of M1.2*7 self-tapping screws cannot be found, it may be packed in the servo package.
- Prepare the Following Four Parts
Get the four parts shown in the following images.
- Install the Body Bracket
Install the body bracket as shown in the images.
- Install the Shield
Install the shield as shown in the images.
- Install the MPU6050
The board has two rows of headers. Plug the MPU6050 into the outer row.
- Install the top bracket
Install the top bracket.
- Connect the LED module
Connect the shield with the LED module. This connection will be helpful for later assembly.
- Install the Raspberry Pi
Attach the Raspberry Pi to the robot dog with four M2.5x8 screws.
- Install the connector
Install the connector to connect the Raspberry Pi and shield.
- Install the connection board
There are two types of connection boards, PCB_V1.0 and PCB_V2.0, but they are installed in the same way.
- Complete the main body assembly
The main body is now assembled. The leg parts will be assembled later.
- Install the servo on the acrylic board
Install the servo on the acrylic board.
- Identify four different parts
There are four parts, and they are different from one another.
- Assemble two sets
Assemble two sets of the parts.
- Assemble parts onto the top
Assemble the parts onto the top.
- Get two sets of joint parts
After assembly, you will have two sets of joint parts.
- Assemble another two parts
Assemble another two parts. They are different from the parts above.
- Assemble two more parts
Assemble another two parts. They are different from the parts above.
- Assemble the parts together
Assemble the parts together.
- Complete four different parts
You will now have the four parts shown below. They are different from one another.
- Connect Servos and Install Batteries
Connect all 12 black servos and 1 blue servo to the servo port randomly. Install the batteries and push them toward the “+” ends.
- Power the Raspberry Pi
The cable can still be used to power the Raspberry Pi. Press S1 and S2, and two indicators will turn on.
- Verify Chapter One Prerequisites
Turn on the Raspberry Pi and make sure all three Chapter 1 steps were completed correctly. Perform the Chapter 1 steps first if they have not been done.
- Connect Servos to Disk Arm
Connect the servos to the disk arm. Keep the power on and all servos connected during assembly, and do not disconnect them.
- Attach Servos at 90 Degrees
Keep the power on and all servos connected to the shield without disconnecting the wiring. Keep the servos at 90° when connecting the servo arms; install them near 90°, within the acceptable range of 65~115.
- Assemble One Side's Legs
Assemble the legs on one side and try to install them at 90°. Angles from 65~115 are acceptable.
- Assemble the Other Side's Legs
Assemble the legs on the other side.
- Install Rear Legs and Screws
Select two legs from different sides as the rear legs, install them as shown, and then install the servo screws.
- Switch Load Off for Screws
If the holes were not covered with tape beforehand, turn off Load S1 to install the screw. Turn Load S1 back on after installing the screw.
- Install Front Legs and Screws
Assemble the front legs and install the servo screw.
- Assemble the Front Legs
Complete the assembly of the front legs.
- Restore Load After Screwing
Turn Load S1 on after the screw is installed.
- Assemble the Robot Head
Assemble the head using the servo arm and screws included in the blue servo package.
- Attach the Head to the Body
Keep the power on and the servo connected while installing the arm. Then shut down the Raspberry Pi and do not turn it on until Chapter 3.
- Wire the Servos and Ultrasonic Module
Connect the servos according to the numbers; servo ports 0, 1, and 14 are spare and not connected. Wire the ultrasonic module without connecting 5V to GND, as this may damage it.
- Connect the Pi3 or Pi4 Camera
The Raspberry Pi must be powered off when plugging or unplugging the camera cable, or the camera module may be burned. Pay attention to the blue side of the cable.
- Connect the Pi5 Camera Cable
This cable is only available with the purchase of the Raspberry Pi 5 version. Connect one end to the Raspberry Pi, observing the front and back of the cable.
Software
- Use SPI MOSI on Raspberry Pi 5
On Raspberry Pi 5, rpi-ws281x-python cannot function properly, so the LEDs use the SPI MOSI pin; the SCK and MISO pins cannot then be used for other purposes.
- Install the Raspberry Pi system
First install a system for the Raspberry Pi. Raspberry Pi 5, 4B, or 3B+ is recommended, together with a 5V/3A power adapter, Micro USB cable, Micro SD card, and card reader.
- Select the Raspberry Pi device
Select the Raspberry Pi device according to its version so the system filters show the appropriate image.
- Choose the downloaded system image
Open “Operating System” and choose the system you just downloaded under “Use custom”.
- Choose the SD card and continue
Select the SD card that will receive the system, then click “Next”.
- Configure the Raspberry Pi
Configure the Raspberry Pi according to your needs.
- Enable SSH and configure WiFi
Enter your information on the “GENERAL” screen and enable SSH on the “SERVICES” page.
- Save and write the system
Click “Save”, then click “Yes” on the new screen and wait for the system to be written to the SD card.
- Connect the display and input devices
Connect a monitor through HDMI, a mouse and keyboard through USB, and a network cable to the network port, then connect a power supply meeting your Pi model’s specifications.
- Log in to Raspberry Pi OS
Start the Raspberry Pi and log in with the default user name “pi” and password “raspberry”.
- Connect to WiFi
Raspberry Pi 5, 4B, and 3B+/3B can connect using their built-in WiFi adaptor; other models can use an external USB wireless card.
- Set VNC Scaling
In the VNC Viewer control panel, right-click, select Properties→Options→Scaling, and set the appropriate scaling.
- Connect Raspberry Pi Wi-Fi
Raspberry Pi 5/4B/3B+/3B integrates a Wi-Fi adaptor. If the Pi is not connected to Wi-Fi, connect it to control the robot wirelessly.
- Choose Remote Desktop Access
If the Raspberry Pi was logged in through a display, skip to VNC Viewer. Without a spare display, mouse, and keyboard, use a remote desktop to share a display, keyboard, and mouse with the PC.
- Log In over SSH
Open the terminal and run the command. If the command does not work, continue to the next page to use the IP address method.
- Enter Raspberry Pi Credentials
The default password is raspberry and is case-sensitive. You may need to type yes during the process.
- Log In by IP Address
Find the IP address named “raspberry pi” in the router client, then use that address to log in to the Pi.
- Confirm SSH Login
When the pi@raspberrypi:~ $ prompt appears, the Pi has been logged in successfully and you can continue to the next section.
- Find the Raspberry Pi IP on Windows
On Windows 10, press Win+R, enter cmd, and use the listed command to check the Raspberry Pi IP address.
- Find the IP in the Router
Alternatively, find the device named “raspberrypi” in the router client. The example Raspberry Pi IP address in the document is 192.168.1.95.
- Connect over SSH
Enter the Raspberry Pi's actual IP address to log in over SSH.
- Enable VNC on Raspberry Pi
Run sudo raspi-config, then select Interface Options→P5 VNC→Enter→Yes→OK.
- Restart and Open VNC
The Raspberry Pi may need to be restarted; choose ok when prompted, then open the VNC interface.
- Download and Install VNC Viewer
Download and install VNC Viewer according to the computer's operating system using the link in the document.
- Create a VNC Connection
After installation, open VNC Viewer and click File→New Connection.
- Enter the Raspberry Pi Connection
Enter the Raspberry Pi IP address, provide a name, and click OK.
- Log in with VNC Viewer
Double-click the new connection in the VNC Viewer panel, enter username pi and password raspberry, and click OK.
- Start the Pi and install libraries
Start the Raspberry Pi with Raspberry Pi OS Desktop and install the necessary libraries; power it with a power supply cable during installation.
- Open the terminal and obtain the code
Power the Raspberry Pi with a power supply cable or switch on S1, then open the Raspberry Pi desktop and terminal to download the code and set python3 as the default.
- Open the Raspberry Pi Terminal
Press “CTRL + ALT + T” on the desktop to open the terminal.
- Download the Robot Dog Code
Enter the user home directory and execute the commands in turn to clone the Robot Dog project code from GitHub. The download may take a long time.
- Check the Default Python Version
Run `python` to check the current default Python version on the Raspberry Pi, then press Ctrl-Z to exit. If it is already python3, skip the remaining default-Python setup steps.
- Enter the Python Link Directory
If the default version is python2, enter the `/usr/bin` directory.
- Delete the Original Python Link
Delete the original `python` link with administrator privileges.
- Create a New Python Link
Create a new link named `python` that points to `python3`.
- Use Terminal Shortcut Keys
Use the up and down arrow keys to browse command history, and use Tab to complete commands or paths; press Tab again when multiple matches are available to list the options.
- Enable I2C, SPI, and VNC
Enable I2C, SPI, and VNC in the Raspberry Pi configuration. The I2C interface is disabled by default and must be opened manually.
- Configure SPI by Connector Version
Turn on the SPI feature for connector version V2.0; turn off the SPI feature for connector version V1.0.
- Open the Raspberry Pi configuration file
Open /boot/firmware/config.txt in the terminal.
- Set the I2C baud rate to 400000
Find dtparam=i2c_arm=on and add i2c_arm_baudrate=400000. Press CTRL+O and Enter to save, then press CTRL+X to exit.
Calibrate and test
- Configure the Raspberry Pi
Configure the Raspberry Pi according to your needs.
- Fill in general settings
On the GENERAL screen, enter information based on the actual situation.
- Enable the SSH service
Enable SSH on the SERVICES page.
- Save and write the system
Click Save, click Yes on the new screen, and wait for the system to be written to the SD card.
- Log in to the Raspberry Pi
After the Raspberry Pi starts and setup is complete, log in with the default user name pi and password raspberry.
- Confirm the operating system installation
After logging in, view the Raspberry Pi OS desktop and confirm that the operating system was installed successfully.
- Connect to Wi-Fi
The Raspberry Pi 5, 4B, and 3B+/3B have integrated Wi-Fi adaptors that can connect to Wi-Fi for wireless remote desktop control.
- Use a USB wireless card
Raspberry Pi models without integrated Wi-Fi can use an external USB wireless card for wireless remote desktop access.
- Verify Remote Desktop Setup
Verify that you have successfully logged in to Raspberry Pi with VNC Viewer and completed the display settings.
- Set the display resolution
If a black window appears, set the resolution. If you do not know which setting to use, try 1920x1080.
- Adjust VNC scaling
Right-click the VNC Viewer control panel, select Properties->Options->Scaling, and set the proper scaling.
- Set All Servos to 90 Degrees
After the program runs, all servos will remain at 90°.
- Check the Servo Connector
If the program reports “Remote I/O error”, check whether the connector is connected properly.
- Check Both Load Switches
If the program reports “Remote I/O error”, confirm that both S1 and S2 are turned on.
- Check Battery Holder Contact
If the program reports “Remote I/O error”, check whether the batteries make good contact with the battery holder.
- Turn on switches and run verification commands
Turn on two switches, change to the Server directory and run the Servo.py script.
- Fix servos if posture is wrong
The robot should show the pictured posture; if not, disassemble the servo screws of incorrect servos and reassemble those servos so the robot matches the posture above.
- Connect the Raspberry Pi to the WAN
Use an Ethernet network cable to connect the Raspberry Pi to a WAN (Wide Area Network).
- Set the display resolution
Set the required display resolution; if you are unsure which one to use, try 1920x1080.
- Adjust the VNC zoom
If the VNC Viewer window zooms the Raspberry Pi desktop, change the zoom setting.
- Verify the New Default Python
Run `python` again to check the link, then press Ctrl-Z to exit.
- Check whether the I2C module is enabled
Run lsmod | grep i2c. If the I2C module is enabled, related content will appear; the numbers on your device may differ.
- Power on and check indicators
Turn on the Raspberry Pi. If the power cable is disconnected, the batteries power the Raspberry Pi; press S1 and S2 to turn on the two indicators.
- Enable I2C and VNC
The I2C interface on the Raspberry Pi is disabled by default. You need to open it manually.
- Check the I2C Module Status
Run lsmod and filter for i2c to check whether the I2C module is enabled. The corresponding content appears when it is enabled, although device numbers may differ.
- Test I2C Communication
The smart car board has PCF8591 and PCA9685 chips at I2C addresses 0X48 and 0X40. Run i2cdetect to check whether the board is connected to the Raspberry Pi; connected devices display their I2C addresses.
- Disable the Raspberry Pi Audio Module
Raspberry Pi models other than 5, 4B, and 400 need the audio module disabled, otherwise the LED will not work properly. Edit snd-blacklist.conf, add blacklist snd_bcm2835, then press Ctrl+O, Enter, and Ctrl+Z to save.
- View GPIO Numbering Correlation
Run the command to view the correlation between BCM, physical, and WiringPi GPIO numbering.
Common problems
- Server fails to autostart after boot #18
- PCA9685 or I/O errors prevent servo initialization #4 #8 #12 #28
- Power issues cause low voltage, clicking, stalled servos, or damaged boards #5 #16 #17 #32
- Incorrect wiring or unsupported hardware prevents LED module operation #6 #23
- Broken instructions or incompatible environments cause camera and dependency setup failures #10 #24 #27 #30 #35 #37
- Missing face model or Qt runtime prevents client startup #1 #9 #25 #36
- Calibration or mechanical misalignment causes misaligned, unresponsive servos, or empty files #14 #15 #33 #38
- Server and motion code contain calculation, variable, and turning defects #21 #29 #31
Parts
- Robot Shield: PCA9685 16-channel servo driver (0.09° resolution), ADS7830, buzzer, four-LED battery gauge, ultrasonic and MPU6050 ports; the connection board comes as V1.0 or V2.0 (V2 moves the LED pin from GPIO18 to GPIO10 for the Raspberry Pi 5)
- Servos: 12 × ES08MA II (legs), 1 × S90 (head)
- Raspberry Pi camera, HC‑SR04 ultrasonic module, MPU6050, RGB LED module; the Raspberry Pi 5 version adds an FPC camera cable
- Acrylic body and hardware, a red tracking ball, 3 mm and 2 mm Phillips screwdrivers, 80 cm of cable wrap
- Not included: a Raspberry Pi (5 / 4B / 3B+ / 3B / 3A+ recommended), two unprotected high-drain 18650 cells (over 10 A continuous) and a charger
Tools
- Screwdrivers are included and the tutorial has no soldering steps
- A microSD card, card reader and power supply for the Pi, plus a monitor or SSH/VNC remote desktop
- An 18650 charger; Calibration_Graph.pdf in the repo serves as the calibration sheet
Skills
- Flashing Raspberry Pi OS, SSH/VNC and the command line
- Python 3: the Pi-side server and the PyQt5 + OpenCV client
- Centring servos before fitting the legs, then calibrating all four legs on the sheet
Software
- Code/Server: the Python server on the Pi (servos, IMU balance, ultrasonic, LEDs, camera), updated through 2025‑12
- Code/Client: the PyQt5 + OpenCV PC client (face recognition, ball tracking, calibration), with Windows and macOS executables
- Freenove app (Android 5.0+, iOS 10+)
- GitHub releases V1.0 / V1.1 (2024‑12) for bullseye and for the Raspberry Pi 5's bookworm