README.md 3.04 KB
Newer Older
Phyks's avatar
Phyks committed
1
2
3
Disty
=====

Phyks's avatar
Phyks committed
4
5
6
Disty is a [hackEns](http://hackens.org) project by [Phyks](http://phyks.me)
and [Elie](http://exppad.com/) aiming at building a low-cost telepresence robot
for videoconference.
Phyks's avatar
Phyks committed
7

Phyks's avatar
Phyks committed
8
9
10
More infos can be found on the [project page](http://hackens.org/disty) (in
French). The README and the source code is another good source of
documentation, which should be self-explanatory, in English.
Phyks's avatar
Phyks committed
11
12
13

This repo contains all the drawings and code we used to make it work.

14
15
![Screen capture](https://raw.githubusercontent.com/hackEns/Disty/master/doc/screenshot.png)

Phyks's avatar
Phyks committed
16
17
<hr/>

18
19
![3D model](https://raw.githubusercontent.com/hackEns/Disty/master/doc/3Dmodel.png)

Phyks's avatar
Phyks committed
20
21
22
23
24
25
26
27
28
<hr/>

![Disty](http://pub.hackens.org/images/disty/disty1.jpg)

![Disty](http://pub.hackens.org/images/disty/disty2.jpg)

![Disty](http://pub.hackens.org/images/disty/disty3.jpg)


Phyks's avatar
Phyks committed
29

Phyks's avatar
Phyks committed
30
## Content of this repo
Phyks's avatar
Phyks committed
31

Phyks's avatar
Phyks committed
32
33
* `blueprints` contains all the blueprints and drawings for this project.
* `disty` contains the main C++ code, responsible for handling Disty movements
34
and basic operations.
Phyks's avatar
Phyks committed
35
* `webview` contains the code for the webview, which is the web interface used
36
to control Disty and display camera (for the remote user).
Phyks's avatar
Phyks committed
37

Phyks's avatar
Phyks committed
38
39
Note that these folders also contain useful READMEs with more detailed
information on them.
Phyks's avatar
Phyks committed
40

Phyks's avatar
Phyks committed
41
Blueprints are either in `eps` (ready to cut files) or `svg` (working files).
42
43
44
45
46
47
48
49
50
These should be the same and both are provided only to ease usage and
modifications. STL files are ready to print files. They should be included in
the Blender blend files, for easy modifications.

You should laser cut the `top` and `bottom` files for the two main plates.
You should 3D print:
* the `picam_case_*` files for the camera case (licensed under CC BY SA).
* `teleprez.blend` is the complete CAO model of the robot in Blender.
* `camera_servo_holder.stl` is the plastic part to hold the camera servo. You
Phyks's avatar
Phyks committed
51
need to print it once (with a 10,000 scale factor).
52
* `wheel_servo_holder.stl` is the plastic part to hold the servos for the
Phyks's avatar
Phyks committed
53
wheels. You need four of them (with a 10,000 scale factor).
54
55
56
57
58


## Wiring

![Wiring](https://raw.githubusercontent.com/hackEns/Disty/master/doc/gpio.png)
Phyks's avatar
Phyks committed
59
60


Phyks's avatar
Phyks committed
61
62
## License

63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
All the source code we wrote is under a beer-ware license, under otherwise specified.

    * --------------------------------------------------------------------------------
    * "THE BEER-WARE LICENSE" (Revision 42):
    * Phyks and Élie wrote this file. As long as you retain this notice you
    * can do whatever you want with this stuff (and you can also do whatever you want
    * with this stuff without retaining it, but that's not cool...). If we meet some
    * day, and you think this stuff is worth it, you can buy us a beer
    * in return.
    *                                                                       hackEns
    * ---------------------------------------------------------------------------------

If you need a more legally valid license, you can consider Disty to be under an MIT license.


## Credits

Thanks https://api.youmagine.com/designs/raspberry-pi-snap-together-camera-case for the camera case (CC BY SA license).