中文文档

pantilt

This is a tool kit containing Python utils

1. for driving servos,
2. for controlling camera at a two-servos pan tilt by widgets in jupyter notebook and a PS4 Joystick.

Quick Guide

1. To Initiate a Servo

from pantilt import Servo
s1 = Servo(channel=14, bus=0, max_angle=180, min_angle=0)

channel is number that servo has connected to PCA9685 board;
bus can be 0 or 1 or even 2;
max_angle min_angle is upper and lower limit we set for the servo.

s1.to_angle(45)
s1.reset()
s1.change_reset(0)
s1.add()
s1.sub(3)
s1.read()
s1.change_unit(30)
s1.to_min()
s1.to_max()

.to_angle() will turn to a angle;
.reset() will turn servo back to the default angle, which is (max_angle+min_angle)/2 as default;
.change_reset() This will change the default reset angle to input number.
Leaving bracket blank as .change_reset() will apply the current angle.

.add() changes the servo by adding one unit of angle, which is 10 degree as default.
.sub() changes the servo by subtracting one unit of angle;
An integer in its bracket means how many unit it will act on.
.change_unit() will change how many degree it turn for one unit.

.read() can read the current angle of the servo.
.to_min() will turn to the minimum angle.
.to_max() will turn to the maximum angle.

You can open a jupyter notebook file, servo_demo.ipynb, to have a try on this tool kit.

2. To Initiate a Pan Tilt

Its methods to control two servos at a pan tilt is similar to control a servo, here is a jupyter notebook file pan_tilt_demo.ipynb

3. Camera Pan Tilt

Walkthrough is here cam_pan_tilt_demo.ipynb

Install

1. Clone the project, please rememeber to clone with parameter —recurse-submodules, because pantilt project referene another submodule bcam.

git clone --recurse-submodules  https://github.com/youyoubilly/pantilt.git

2. Install pantilt

STL 3D Model

You are welcome to download the stl file I designed for this simple pan tilt of CSI camera, and 3D print it out.
You may adjust the stl model for different use.

Other Languages

English document is available here: GitHub - pantilt
Chinese document is available here: 中文传送门; 国内仓库：Gitee传送门

It would be appreciated if you can contribute to write this document in other languages!

Donate

This project is developed on a non-commercial basis by Open Source enthusiasts.
If you find pantilt useful, you can support the lead developer by donating a few dollars via PayPal. With this money, we will be able to buy new hardware to test and do more such project for open source and for free education, and generally devote significantly more time to these projects.

Notes

If you find an issue, please let us know!

Sorry that I may have some typos or inaccurate expression in English, help me to correct them if you found one! Big Thanks!

Enjoy!

Useful Links

• Project: billiocar
  Let's learn and play an robotic car with AI technology

• Project: pantilt
  This is a tool kit for controlling two servos at a pan tilt in jupyter notebook.

• Project: bcam
  bcam is an easy to use Python camera interface for NVIDIA Jetson and Raspberry Pi.

Billy Wang
BillioTech Team