Connecting to sources…

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

Documents