Hiwonder SpiderPi User Manual

Hiwonder SpiderPi User Manual

Intelligent coding robot kit

Advertisement

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SpiderPi and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Hiwonder SpiderPi

  • Page 2: Table Of Contents

    First Part: Operation Guide .................. 3 1. Caution ....................3 Product List .................. 3 Charging ..................3 Operation ..................4 Control and Connection ..............4 2. Mobile APP Control ................. 4 2.1. Mobile APP Installation ..............4 2.2. Mobile APP Connection ..............5 2.3.
  • Page 3: First Part: Operation Guide

    First Part: Operation Guide 1. Caution Product List After receiving the Raspberry Pi hexapod robot, you need to check it according to the Product list. Charging Since the battery cannot include power during transportation, please charge the battery for more than 2 hours. The robot kit consists of a rechargeable lithium battery and charger.
  • Page 4: Operation

    3 ) When the battery voltage is lower than 9.6V, the robot will stop working. Charge it on time; otherwise, it may damage due to over- discharge. Operation 1 ) Whatever the finished product or the unassembled parts package, the SD memory card has a download system image. 2 ) When the robot is working, keep the robot away from your eyes to avoid accidental injury.
  • Page 5: Mobile App Connection

    Image 2-1 WonderPi Installation Package QR Code 2.2. Mobile APP Connection Because the Raspberry Pi is able to launch Wi-Fi hotspot in the default mode. After our mobile phone connects to the Wi-Fi created by the Raspberry Pi. Following the instructions below to help the APP connect to the Raspberry Pi robot.
  • Page 6: Mobile App Operation

    Image 2- 2 Phone Wi-Fi Interface 3 ) Open the WonderPi software you just installed, click the search button in the upper right corner. When the robot icon shown below appears, click the robot icon to connect to the robot. Image 2- 3 Mobile Phone APP Search Robot 2.3.
  • Page 7 Table 1 APP Icon Function Table Icon function icon function Click this button to Click this button to return to the device take a photo and selection interface save it to your phone. Click this button, Click this can and the options bar show the action will not appear on group...
  • Page 8 Image 2-5 Control System Interface Image 2-6 Switching the Gameplay...
  • Page 9: Computer Control

    3. Computer Control Control Software Download Go to the "3. Basic Tutorial -> 3. Computer Control Software " folder in the data and open the icon application directly (turn off the firewall before opening the application ). Image 3- 1 Terminal Application Controlling Software Connection 1 ) Turn on the Raspberry Pi power switch 2 ) When Raspberry Pie is turning on, it will automatically launch a first...
  • Page 10: Controlling Software Operation

    Controlling Software Operation 1 ) Click the "Scan" button to scan the hotspot. after opening the 5.1 version terminal application Image 3- 3 Interface Display 2 ) When the scan finishes, the camera's image will appear on the software interface.
  • Page 11 Image 3- 4 interface display 3 ) Next, you can control the movement of the robot by clicking these motion buttons on the left side of the interface. VNC Installation The Raspberry Pi is as a stand-alone minicomputer, so you can't connect the Raspberry Pi to the computer directly through the data cable.
  • Page 12 Image 4-2 VNC Installation Process 3 ) Click "Accept agreement" in the prompt box, and click "Next" to enter the next step. Image 4-3 VNC Installation Agreement 4 ) Click "Install" in the pop-up page.
  • Page 13 Image 4- 4 VNC Installation Reminder 5 ) Wait for the installation. Click the “Finish” button to end this installation. When all things are done, open VNC. Figure 4- 5 VNC Installation Completion Prompt 6 ) After connecting the VNC successfully Double- click to open...
  • Page 14: Second Part: Advanced Tutorial

    Second Part: Advanced Tutorial 1. How to do the gameplay 1 ) Use the charger to charge the battery (After charging finishes the battery charger indicator will switch turn from the red to the green). Insect battery to the Raspberry Pi, and turn on its power switch. The LED1 and LED2 of the Raspberry Pi will keep on.
  • Page 15 Image l-2 IP Input Mode 4) Enter the password raspberry in the pop-up prompt box. (if it " " requires to enter the account name, please "pi"), check the "Remember password" box, and then click "OK". Raspberry Pi's desktop will display on your computer’s monitor.
  • Page 16 5 ) Click the LX terminal in the upper left corner (or click the shortcut key Ctrl+Alt+T ), enter "cd hexapod/" and press "Enter" to locate the directory where the game program is stored. Image l-4 Terminal Open Position Image 1-5 Locate the Game Directory 6 ) Enter ls -l ( This 'l' is the English letter 'L' Image 1-6 Enter the command to open the game program...
  • Page 17 Image 1-7 Gameplay Directory File 8 ) When you want to run gameplay, you can enter "python3 program name.py" and press "Enter" to run the gameplay. For example, to run the colour identification gameplay program "cv_color_stream.py" , you can enter the "python3cv_color_stream.py" command. Image 1- 8 Enter Specified Gameplay Command 9 ) After pressing the "Enter", the camera image will pop up.
  • Page 18 Image 1- 9 Color Identification Gameplay Running Interface 10 ) If you want to stop the game program, you can click the LX terminal part and let its window be at the front, then press "Ctrl+C" on the keyboard at the same time to stop running the game program.
  • Page 19 2. Colour Identification This gameplay mainly uses the camera to identify the object colour and let the robot do specific action according to this, if the object is red, the robot will nod, otherwise it will shake its head. 1 ) Start the VNC to remotely connect to the robot. Open the LX terminal (shortcut Ctrl+Alt+T ), enter the command as shown below and press "Enter"...
  • Page 20 3. Cloud Head Colour Tracking In the last lesson, we have learned about the Raspberry Pi color recognition function. In this lesson, we will learn how to let the robot recognise the colour and let the camera follow the object of the target colour as well 1 ) Start the VNC to remotely connect to the robot.
  • Page 21 4. Body Colour Tracking Last lesson we have learned about Raspberry Pi cloud head tracking, this lesson we will learn how to make the robot move with the target colour object 1 ) Start the VNC to remotely connect to the robot. Open the LX terminal (shortcut Ctrl+Alt+T ), enter the command as shown below and press "Enter"...
  • Page 22 5. Organism Self-balance Spider Pi hexapod robot has a self-balancing function that automatically adjusts the foot when the terrain is tilted, keeping the body, camera, sensor, and controller balance. However, for some reasons, the angle of the six-legged inclination is limited, and the sum of the absolute values of the roll and pitch angles should be less than 30°...
  • Page 23: Ultrasonic Obstacle Avoidance Code

    6. Ultrasonic Obstacle Avoidance Ultrasonic Obstacle Avoidance Code 1 ) Start the VNC to remotely connect to the robot. Open the LX terminal (shortcut Ctrl+Alt+T ), enter the command as shown below and press "Enter" to locate the image recognition directory. Image 6-1 Ultrasonic Obstacle Avoidance Program Loaction 2 ) Put the robot on the ground, then enter the command shown below and press "Enter".
  • Page 24 Image 6-3 Open Ultrasonic Obstacle Avoidance Program 2 ) Enter "23" , then press and hold the "shift+g" button on the keyboard to automatically jump to the 23rd line. Press the "i" button on the keyboard to enter the editor mode. The “40” shown on the red box below is the ultrasonic default distance unit centimetres.
  • Page 25 Image 6-5 Rotation Parameter Setting 4 ) Press the "Esc" key on the keyboard to exit the editor mode and enter the ":wq" command to save the file and exit the LX editor.
  • Page 26: Visual Patrol

    7. Visual Patrol 1 ) Start the VNC to remotely connect to the robot. Open the LX terminal (shortcut Ctrl+Alt+T ), enter the command as shown below and press "Enter" to locate the image recognition directory. Image 7-1 Visual Patrol Program Loaction 2 ) Next, enter the command shown below.
  • Page 27: Advanced Tutorial

    8. Advanced Tutorial Modify the Identification Color 8.1.1. Lab Colour Space The default color of color identification gameplay is the blue, change the parameter in the program to modify the default color. Usually, the color space we use is RGB color, which color display is based on a mixture of three original color red, green and blue.
  • Page 28: The Method Of Turning Rgb To Lab

    8.1.2. The Method of Turning RGB to Lab Following the steps below to turn RGB to Lab. 1 ) Open the PS software and import the target image. 2 ) Use the "Sipper tool" in the PS to select the colour you want. 3 ) Click on the Color Picker at the bottom left to see the between Lab...
  • Page 29 Image 8-4 Default Color Parameters 2 ) Click the icon below the, and click "Execute", if the prompt box come out. Image 8- 5 Open the LAB Tool 3 ) Point the camera at the colour you want to recognise, and the right side box first selects "red"...
  • Page 30 Image 8-6 Modified to Orange 4 ) After the modification complete, we can check if the modified value is successfully written in, and then enter the following command to check the colour setting program. Image 8- 7 Open the Color Setting Program 5 ) Check the command marked by red frame below.
  • Page 31: Raspberry Pi Hotspot Modification

    6 ) Put the orange object in front of the camera. It can be seen that the program has changed from red to the orange. Image 8- 9 Recognition Effect Raspberry Pi Hotspot Modification In this section, we will teach you how to change the default Wi-Fi name and password.
  • Page 32 4 ) The interface is as shown: Image 8-11 Configuration File Display 5 ) Click "i" will display "- Insert -"on the left. Modify the parameter according to your needs. Image 8-12 Insert mode...
  • Page 33 6 ) For example, If you change the Raspberry Pi Wi-Fi name to "Hiwonder" and password to "28433321" , you only need to modify the command like the image below. Cautious: command only works after uncomment "#" . Image 8-13 Modify the Wi-Fi Name and Password 7 ) After the modification completed, press the "ESC"...
  • Page 34: Common Linux Commands

    Image 8-15 Restart Command Image 8-16 Wi-Fi Connection Page Common Linux Commands Table 2 Linux Common Command Table Command name Full name in English Description lists the files in the List current directory Change Directory Switch directory path Print Working Directory display the directory Test network ping...
  • Page 35 inputting echo Echo command echo back to the terminal interface commands sudo Superuser do system administrator Clear clear Clear command terminal...
  • Page 36: Frequently Asked Question(Faq)

    Frequently Asked Question(FAQ) Command Problem Question 1: Does the Raspberry Pi memory card need to burn the system image? Answer: Whether the unassembled parts of finished parts product kit, the system image has already burned in the memory card, Question 2: Can the robot be used directly without programming? Answer: Yes.
  • Page 37 Answer: This is because the head part servo hasn’t adjusted properly. Follow the steps below to adjust neck part servo to the middle position. 1 ) Click the "Red" button on the APP to let the robot stand. If the robot head turns to the one side, It means the position of the servo is not in the middle of it has rotates before installation.
  • Page 38: Robot Section

    Robot Section Question 1: Why does the robot move in the opposite direction? Answer: In this case, please check whether the installation of the main and assistant servo horns are reversed. The metal shaft side connects to the main servo horn, and the plastic shaft side it connects to the associate servo horn.
  • Page 39 Image 9-3 Before Connecting the Camera 2 ) Insert the camera connecting the wire on the Raspberry Pi USB port and enter the command "lsusb" again. If it works properly, The ID number of the camera will appear. Image 9-4 Camera ID 3 ) After inserting the connecting wire, restart the Raspberry Pi.
  • Page 40: Raspberry Pi Section

    4 ) Click the browser icon on the interface, and enter the address "http://127.0.0.1:8080/?action=stream?dummy=param.mjpg". If the camera works properly, the camera image will come out. Image 9-5 Real-time Image Question 4: Why do I refer to the tutorial above to modify the program, the colour identification function still cannot work correctly? Answer: Because colour identification is greatly affected by the environment, adjust the range of Lab values can solve this problem...
  • Page 41: More Information

    LED2 indicator on the Raspberry Pi expansion board will turn to the frequent flash mode. Please charge it in time to avoid over-discharge of the lithium battery. 10. More Information 10.1 Contact us Contact e-mail: support@hiwonder.com 9:00-21:00 on weekdays. Official website: www.hiwonder.com...
  • Page 42 Company Address: 2nd Floor, Building B, Cultural Innovation Park, No. 1 Dongjin Road, No. 227 Ai Nan Road, Longgang Street, Longgang District, Shenzhen, Guangdong, China...

Table of Contents