SunFounder PiDog User manual

SunFounder PiDog Kit
Release 1.0
sunfounder
Jan 09, 2023

CONTENTS
1 Component List and Assembly Instructions 3
2 Play with Python 5
2.1 Quick Guide on Python ......................................... 5
2.2 Funny Project ............................................... 44
2.3 Easy Coding ............................................... 75
3 Hardware 89
3.1 Robot HAT ................................................ 89
3.2 Camera Module ............................................. 91
3.3 Sound Direction Sensor ......................................... 95
3.4 6-DOF IMU ............................................... 96
3.5 Dual Touch Sensor ............................................ 97
3.6 11-channel Light Board ......................................... 97
3.7 Ultrasonic Module ............................................ 98
3.8 18650 Battery .............................................. 100
4 Appendix 101
4.1 Filezilla Software ............................................. 101
4.2 Get the IP address ............................................ 103
5 Copyright Notice 105
i

ii

SunFounder PiDog Kit, Release 1.0
Thank you for choosing our PiDog.
PiDog is a Raspberry Pi pet robot with aluminum alloy structure. It can act as a mechanical pet, show cuteness to you,
and interact with you.
It is equipped with a camera module, which can perform color recognition, face detection and other projects; 12 metal
gear servos support it to walk, stand, sit, shake its head, and pose in various poses; The ultrasonic module on the head
enables it to quickly detect obstacles ahead; Special touch sensors allow it to respond to your touch; The Light Board
on the chest can emit colorful light effects, and with the speaker equipped with the robot HAT, PiDog can express
emotions such as happiness and excitement. In addition, PiDog is also equipped with a sound direction sensor and a
6-DOF IMU module to realize more complex and interesting usage scenarios.
This document includes the list and assembly pdf, hardware introduction and PiDog programming.
CONTENTS 1

SunFounder PiDog Kit, Release 1.0
Content
2 CONTENTS

CHAPTER
ONE
COMPONENT LIST AND ASSEMBLY INSTRUCTIONS
You need to check whether there are missing or damaged components according to the list first. If there are any
problems, please contact us and we will solve them as soon as possible.
Please follow the steps on the PDF to assemble.
If the servo has been powered on, please do not turn the Servo shaft to avoid damage.
•Component List and Assembly Instructions.
3

SunFounder PiDog Kit, Release 1.0
4 Chapter 1. Component List and Assembly Instructions

CHAPTER
TWO
PLAY WITH PYTHON
If you want to program in python, then you will need to learn some basic Python programming skills and basic
knowledge of Raspberry Pi, please configure the Raspberry Pi first according to Quick Guide on Python.
2.1 Quick Guide on Python
This section is to teach you how to install Raspberry Pi OS, configure wifi to Raspberry Pi, remote access to Raspberry
Pi to run the corresponding code.
If you are familiar with Raspberry Pi and can open the command line successfully, then you can skip the first 3 parts
and then complete the last part.
2.1.1 What Do We Need?
Required Components
Raspberry Pi
The Raspberry Pi is a low cost, credit-card sized computer that plugs into a computer monitor or TV, and uses a
standard keyboard and mouse. It is a capable little device that enables people of all ages to explore computing, and to
learn how to program in languages like Scratch and Python.
5

SunFounder PiDog Kit, Release 1.0
Power Adapter
To connect to a power socket, the Raspberry Pi has a micro USB port (the same found on many mobile phones). You
will need a power supply which provides at least 2.5 amps.
Micro SD Card
Your Raspberry Pi needs an Micro SD card to store all its files and the Raspberry Pi OS. You will need a micro SD
card with a capacity of at least 8 GB
Optional Components
Screen
To view the desktop environment of Raspberry Pi, you need to use the screen that can be a TV screen or a computer
monitor. If the screen has built-in speakers, the Pi plays sounds via them.
Mouse & Keyboard
When you use a screen , a USB keyboard and a USB mouse are also needed.
HDMI
The Raspberry Pi has a HDMI output port that is compatible with the HDMI ports of most modern TV and computer
monitors. If your screen has only DVI or VGA ports, you will need to use the appropriate conversion line.
Case
You can put the Raspberry Pi in a case; by this means, you can protect your device.
6 Chapter 2. Play with Python

SunFounder PiDog Kit, Release 1.0
Sound or Earphone
The Raspberry Pi is equipped with an audio port about 3.5 mm that can be used when your screen has no built-in
speakers or when there is no .00 screen operation.
2.1.2 Installing the OS
Required Components
Any Raspberry Pi 1 * Personal Computer
1 * Micro SD card
Step 1
Raspberry Pi have developed a graphical SD card writing tool that works on Mac OS, Ubuntu 18.04 and Windows,
and is the easiest option for most users as it will download the image and install it automatically to the SD card.
Visit the download page: https://www.raspberrypi.org/software/. Click on the link for the Raspberry Pi Imager that
matches your operating system, when the download finishes, click it to launch the installer.
Step 2
When you launch the installer, your operating system may try to block you from running it. For example, on Windows
I receive the following message:
If this pops up, click on More info and then Run anyway, then follow the instructions to install the Raspberry Pi
Imager.
Step 3
Insert your SD card into the computer or laptop SD card slot.
Step 4
2.1. Quick Guide on Python 7

SunFounder PiDog Kit, Release 1.0
Warning: Upgrading the Raspberry Pi OS to Debian Bullseye will cause some features to not work, so it is
recommended to continue using the Debian Buster version.
In the Raspberry Pi Imager, click CHOOSE OS -> Raspberry Pi OS(other).
Scroll down to the end of the newly opened page and you will see Raspberry Pi OS(Legacy) and Raspberry Pi
OS Lite(Legacy), these are security updates for Debian Buster, the difference between them is with or without the
desktop. It is recommended to install Raspberry Pi OS(Legacy), the system with the desktop.
8 Chapter 2. Play with Python

SunFounder PiDog Kit, Release 1.0
Step 5
Select the SD card you are using.
Step 6
To open the advanced options page, click the setting button (appears after selecting operating system) or press
Ctrl+Shift+X. Enable ssh and set the username and name. You can choose to always use this image customization
options.
Note: When the Set hostname box is not checked, the default hostname will still be raspberrypi, and we will use
this hostname to access the Raspberry Pi remotely.
2.1. Quick Guide on Python 9

SunFounder PiDog Kit, Release 1.0
Then scroll down to complete the wifi configuration and click SAVE.
Note: wifi country should be set the two-letter ISO/IEC alpha2 code for the country in which you are using
your Raspberry Pi, please refer to the following link: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_
assigned_code_elements
10 Chapter 2. Play with Python

SunFounder PiDog Kit, Release 1.0
Step 7
Click the WRITE button.
2.1. Quick Guide on Python 11

SunFounder PiDog Kit, Release 1.0
Step 8
If your SD card currently has any files on it, you may wish to back up these files first to prevent you from permanently
losing them. If there is no file to be backed up, click Yes.
12 Chapter 2. Play with Python

SunFounder PiDog Kit, Release 1.0
Step 9
After waiting for a period of time, the following window will appear to represent the completion of writing.
2.1. Quick Guide on Python 13

SunFounder PiDog Kit, Release 1.0
2.1.3 Set up Your Raspberry Pi
If You Have a Screen
If you have a screen, it will be easy for you to operate on the Raspberry Pi.
Required Components
Any Raspberry Pi 1 * Power Adapter
1 * Micro SD card 1 * Screen Power Adapter
1 * HDMI cable 1 * Screen
1 * Mouse 1 * Keyboard
1. Insert the SD card you’ve set up with Raspberry Pi OS into the micro SD card slot on the underside of your
Raspberry Pi.
2. Plug in the Mouse and Keyboard.
3. Connect the screen to Raspberry Pi’s HDMI port and make sure your screen is plugged into a wall socket and
switched on.
Note: If you use a Raspberry Pi 4, you need to connect the screen to the HDMI0 (nearest the power
in port).
4. Use the power adapter to power the Raspberry Pi. After a few seconds, the Raspberry Pi OS desktop will be
displayed.
14 Chapter 2. Play with Python

SunFounder PiDog Kit, Release 1.0
If You Have No Screen
If you don’t have a monitor, you can remotely log into your Raspberry Pi.
You can apply the SSH command to open the Raspberry Pi’s Bash shell. Bash is the standard default shell for Linux.
The shell itself is a command (instruction) when the user uses Unix/Linux. Most of what you need to do can be done
through the shell.
If you’re not satisfied with using the command window to access your Raspberry Pi, you can also use the remote
desktop feature to easily manage files on your Raspberry Pi using a GUI.
See below for detailed tutorials for each system.
Mac OS X user
For Mac users, accessing the Raspberry Pi desktop directly via VNC is more convenient than from the command line.
You can access it via Finder by entering the set account password after enabling VNC on the Raspberry Pi side.
Note that this method does not encrypt communication between the Mac and Raspberry Pi. The communication will
take place within your home or business network, so even if it’s unprotected, it won’t be an issue. However, if you are
concerned about it, you can install a VNC application such as VNC® Viewer.
Alternatively it would be handy if you could use a temporary monitor (TV), mouse and keyboard to open the Raspberry
Pi desktop directly to set up VNC. If not, it doesn’t matter, you can also use the SSH command to open the Raspberry
Pi’s Bash shell and then using the command to set up the VNC.
•Have Temporarily Monitor (or TV)?
•Don’t Have Temporarily Monitor (or TV)?
2.1. Quick Guide on Python 15

SunFounder PiDog Kit, Release 1.0
Have Temporarily Monitor (or TV)?
1. Connect a monitor (or TV), mouse and keyboard to the Raspberry Pi and power it on. Select the menu according
to the numbers in the figure.
2. The following screen will be displayed. Set VNC to Enabled on the Interfaces tab, and click OK.
16 Chapter 2. Play with Python