ADEEPT RaspTank User manual

www.adeept.com
1

www.adeept.com
1
Warning
Please pay attention to the following issues when purchasing or using the product:
There are small components included in this kit. Swallowing mistakenly or misoperation can
cause serious infection and be even fatal. When an accident occurs, please seek medical
assistance immediately.
Please place the product in a safe place where an under-6-year-old cannot touch, who should
not use or approach the product.
Juveniles should use the product with their parents.
Do not place the product or the components near any AC socket or other circuitsto avoid
electric shock.
Do not use the product near any liquid or flame.
Do not use or store the product in an extreme environment such as in extremely low or high
temperature and heavy humid.
Please remember to power off when the product is not in use.
Do not touch the moving or rotating part of the product.
The product may get heat at some part, which is just normal. But misoperation may cause
overheat.
Misoperation may cause damage to the product. Please take care.
Do not connect the positive and negative poles of the power inversely, or the devices in the
circuit may be damaged.
Please place and put the product gently. Do not smash or shock it.
About
Adeept is a technical service team of open source software and hardware. Dedicated to applying
the Internet and the latest industrial technology in open source area, we strive to provide the
best hardware support and software service for general makers and electronic enthusiasts
around the world. We aim to create infinite possibilities with sharing. No matter what field you
are in, we can lead you into the electronic world and bring your ideas into reality.
The code and manual of our product are open source. You can check on our website:
http://www.adeept.com/
If you have any problems, feel free to send an email for technical support and assistance:
[e-mail]
On weekdays, we usually will reply within 24 hours. Also welcome to post in our official forum:
http://www.adeept.com/forum/

www.adeept.com
2
Copyright
This user manual and code can be used for learning, DIY, refitting, etc., except for commercial
purpose. The Adeept Company owns all rights of contents in the manual, including but not
limited to texts, images, data, etc. Any distribution or printing should be implemented with the
permission of the Company, or it will be deemed illegal.

www.adeept.com
contents
1.Components List...............................................................................................................................1
1.1.Acrylic Plates......................................................................................................................... 1
1.2.Machinery Parts.................................................................................................................... 3
1.3.Transmission Parts.................................................................................................................4
1.4.Electronic Parts......................................................................................................................4
1.5.Tools.......................................................................................................................................6
1.6.Self-prepared Parts................................................................................................................6
2.Assembly...........................................................................................................................................7
2.1.Preparations before Assembly.............................................................................................. 7
2.2. Servo debugging...................................................................................................................9
2.3. Rocker arm assembly..........................................................................................................16
2.4. Body part assembly............................................................................................................ 28
2.5. Track assembly....................................................................................................................49
3. Software & Hardware....................................................................................................................53
3.1. Software Installation.......................................................................................................... 53
3.2. Download Program............................................................................................................ 58
3.3. Install Python3.7 in the PC................................................................................................. 59
3.4. Run the RaspTank...............................................................................................................61
4.Afterword....................................................................................................................................... 64

www.adeept.com
1
1.Components List
1.1.Acrylic Plates
A02
1pcs
A01
1pcs
A04
1pcs
A03
1pcs
A08
1pcs
A09
1pcs
A07
2pcs
A06
1pcs
A05
1pcs
A10
1pcs
A11
1pcs
A12
1pcs
A13
6pcs
A16
1pcs
A15
4pcs
A17
1pcs
A14
2pcs

2
www.adeept.com
The acrylic plates are fragile, so please be careful when assembling them in case of breaking.
The acrylic plate is covered with a layer of protective film. You need to remove it first.
Some holes in the acrylic may have residues, so you need to clean them before the use.
A19
1pcs
A18
1pcs
A22
3pcs
A21
1pcs
A20
1pcs
A26
1pcs
A25
2pcs
A24
1pcs
A23
1pcs
A27
1pcs
A28
1pcs

www.adeept.com
3
1.2.Machinery Parts
www.adeept.com
M2
Nut
X14
www.adeept.com
M2.5
Nut
X4
www.adeept.com
M3
Nut
X12
www.adeept.com
M3
Lock
Nut
X3
www.adeept.com
M2*10
Screw
X14
www.adeept.com
M2.5*4
Screw
X4
www.adeept.com
M2.5*8
Screw
X4
www.adeept.com
M3*8
Screw
X28
www.adeept.com
M3*12
Screw
X12
www.adeept.com
M3*18
Screw
X1
www.adeept.com
M3*30
Screw
X2
www.adeept.com
M4*6
Screw
X2
www.adeept.com
M3*10
Countersunk
Head
Screw
X2
www.adeept.com
M1.4*6
Self-tapping
Screw
X16
www.adeept.com
M2.5*4+6
Copper
Standoff
X8
www.adeept.com
M3*6
Copper
Standoff
X2
www.adeept.com
M3*8
Copper
Standoff
X1
www.adeept.com
M3*18
Copper
Standoff
X8
www.adeept.com
M3*35
Copper
Standoff
X2
www.adeept.com
M3*30
Nylon
Standoff
X1
www.adeept.com
M3*40
Nylon
Standoff
X2

4
www.adeept.com
GA12-N20 Gear Motor x2
Motor Seat Set x2
M2 Nut-B
X 2
M2*10 Screw-B
X 2
N20 Motor Seat
X 1
1.3.Transmission Parts
1.4.Electronic Parts
Servo x5
S12D3 Coupling Set x2
M4*4 Locking Screw x2
S12D3 Coupling x1
Track x2
Adeept Motor HAT X1
Raspberry Pi Camera X1

www.adeept.com
5
Adeept Ultrasonic Module X1
18650 Battery Holder Set X1
3 Tracking Module X1
Car Light X4
Raspberry P1 Camera Ribbon X1
3-Pin Wire -A X3
3-Pin Wire -B X1
4-Pin Wire X1
5-Pin Wire X1
Servo Extension Cable X1

6
www.adeept.com
Cross Socket Wrench X1
Cross Screwdriver X1
Hex Wrench-2.0mm X1
Large Cross-head Screwdriver X1
Winding Pipe X1
Raspberry Pi X1
1.5.Tools
1.6.Self-prepared Parts
18650 battery specification:
It is recommended to use lithium battery above 3000mAh and without overcurrent protection.
The power supply current requirement is above 3A. Using 18650 lithium battery with overcurrent
protection function, 18650 battery whose capacity is less than 1700mAh, 18650 battery specially
for strong-light flashlight, 18650 battery with power shortage or counterfeit lithium battery
produced by informal manufacturers will cause the unstable work of the robot,power cut and
even damage to the Raspberry Pi and robot.
The robot can be turned on normally,but the Raspberry Pi will automatically restart or shut down
after, also because of the problem caused by the 18650 battery.
Ribbon X1
18650 Battery X2

www.adeept.com
7
Assemble the following components
Effect diagram after assembling
Assemble the following components
Effect diagram after assembling
2.Assembly
2.1.Preparations before Assembly
1.Connect the Raspberry Pi Camera and the ribbon.
2.Connect the Adeept Ultrasonic Module with 4-Pin wire.
Raspberry Pi Camera x1
Raspberry Pi Camera Ribbon x1
Adeept Ultrasonic Module x1
4-Pin wire x1

www.adeept.com
8
Effect diagram after assembling
The connection diagrams of the remaining modules and wires are as follows：
3. Screw the M4*4 Locking Screw into the S12D4 Coupling (2 sets).
3 Tracking Module+5-Pin wire 1 set
The two plugs of 3-Pin Wire-A are small plugs, 3-Pin Wire-B has a small plug at one
end and a large plug at the other end. To prevent confusion between the following
two components when reading the manual, we define the following two components
as Car Light-A and Car Light-B.
Car Light+3-Pin Wire -A 3 sets
Defined as Car Light-A
Wires are connected to
the input of Car Light (the
end marked with a white
strip pattern)
Car Light+3-Pin Wire -B 1 set
Defined as Car Light-B
Assemble the following components
M4*4 Locking Screw x2
S12D4 Coupling x1

www.adeept.com
9
Effect diagram after assembling
2.2. Servo debugging.
1. Fix four M2.5x4+6 Copper Standoffs on Raspberry Pi.
Assemble the following components
M2.5x4+6 Copper
Standoff x4
Raspberry Pi x1
M2.5x4
Screw x4

www.adeept.com
10
Effect diagram after assembling
2. Fix A06 to Raspberry Pi.
Assemble the following components
For continence to read, the acrylic
sheets in the document are
available in a variety of colors. The
color of them is subject to actual
conditions, and their number is
differentiated by shape.
M2.5x4+6 Copper
Standoff x4
A06 x1

www.adeept.com
11
Effect diagram after assembling
3. Insert the Adeept Motor HAT into Raspberry Pi.
Assemble the following components
Adeept Motor HAT
x1

www.adeept.com
12
示意图
4. Connect the 18650 Battery Holder Set to the Adeept Motor HAT.
Note that the switch is "OFF".

www.adeept.com
13
Roll one end of the ribbon to let through a battery and fix.
Insert the batteries into the rings - ribbon closer to the anode.
Install the batteries into the holder based on the pole.
To remove the batteries, just pull the ribbon and take them out.
5. Put two 18650 batteries in 18650 Battery Holder Set according to the following method.
Take out 1 ribbons and 1 batteries.

www.adeept.com
14
6. Connect five servos to Adeept Motor HAT.
The color of the servo wire
corresponds to the color of the
port.
Only the servo terminals are
shown here. Connect the 5 servos
to port 11, 12, 13, 14, 15
respectively.

www.adeept.com
15
7. Turn on the power and debug the servo.
Before switching on, you need to insert the configured SD card into the Raspberry Pi. For details,
please refer to the third chapter of the document. That in the next operation, the Pi Camera of
the Raspberry Pi should always be connected to the Raspberry Pi, and do not reverse the wires of
the Raspberry Pi. Otherwise, the servo will not rotate to the middle position after booting.
If SD card is not inserted, the servo needs to be rotated to the middle position manually.
After debugging, remove the servo and battery holder, and take the 18650 batteries out of the
Holder Set. Do not rotate the rotation axis before the servo fixed to the rocker arm. Otherwise,
you need to re-debug the servo.
Turn the switch here to “ON” (power on), the servo will automatically rotate to the
initial position. Wait a few seconds till the servo stop, and then turn the switch to
“OFF” (power off).

www.adeept.com
16
2.3. Rocker arm assembly.
1. Take two rocker arms as in the illustration and connect them to A18.
2.Fix a debugged servo to A17.
Effect diagram after assembling
Assemble the following components
A18 x1
Rocker arm x2
At this time, the rocker arm hasn’t been
fixed. When fixing, the mounting hole
of the rocker arm should be aligned
with the round hole on the A07.
Self-tapping screw packaged
with servo x2
Effect diagram after assembling
Assemble the following components
M2*10 Screw x2
A17 x1
A22 x1
Servo x1
M2 Nut x2