-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.md~
73 lines (48 loc) · 4.61 KB
/
README.md~
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
Dot Bot
=======
## Description
Dot Bot is an experimental project using an **Arduino Yùn** and **Google Analytics Real Time API** (beta).
Dot Bot is basically an adaptation of a vertical plotter that replaces the pen with a led matrix panel and the paper with a World planisphere.
It moves over the planisphere fixed on the wall and stops over the position of the current visitor on our website ([www.dotdotdot.it](http://www.dotdotdot.it)), showing information as latitude, longitude, city and the page visited on its led matrix panel. These information are gathered using Google Analytics Real Time API (which is still in beta).
When none is connected, the led panel goes back to the center of the map and shows the latest tweets made by our Twitter account ([@dot_cube](https://twitter.com/dot_cube)), using the **python-twitter** library.
## Folders
* `code/` - this folder contains the "Linino-side" code, written in Python, that queries Twitter and Google Analytics Real Time
* `sketch/` - this folder contains the Arduino sketch and the libraries to support the MotorShield and the ht1632c led matrix
* `etc/init.d/` - this folder contains the startup script that starts automatically at boot time
## Linino-side configuration
1. Edit `code/twitter_default.cfg` with your keys and secrets values obtained from [Twitter](https://dev.twitter.com/), and save it as `code/twitter.cfg`.
3. Request the access to the Real Time Reporting API Private Beta and create a new project on your [Google Developers Console](https://console.developers.google.com).
4. Enable "Analytics API" under `APIs & auth > APIs` and create a new client ID under `APIs & auth > Credentials` selecting `Installed application - Other`.
5. Download the JSON file by clicking on "Download JSON", rename it to `client_secrets.json` and put it in the `code/` folder.
6. Run `code/renewtoken.py` to create a new `sample.dat` file that contains the access token to Google Analytics Real Time API.
There are two ways to execute the script:
**on your machine** - it opens the default browser and asks to login with the credentials who received access to the beta API. After this, you have to copy the generated `sample.dat` file to the Arduino Yùn, in the `code/` folder.
**on your Arduino Yùn** - needs the `--noauth_local_webserver` parameter. It shows a personal URL, that you have to copy and paste on your machine, and enter the verification code obtained after the login.
7. Type `/etc/init.d/ga enable` on Yùn to enable the service autostart.
## Arduino configuration
TODO
## Calibration
The first time you upload the sketch on your Yùn you have to connect using the Arudino IDE console, it shows a simple menu to calibrate the led panel in the center of the map.
To move the led panel use the syntax `X:Y` (note: values are absolute, not relative). When calibration is done, press `H` and then `A` to start auto mode.
Dot Bot shows, on its led panel, service messages in red color and normal messages in green color.
==================
Welcome to DotBot!
==================
H) to set Home (center of map)
M) to start Manual mode
A) to start Auto mode
X:Y) to move in position (X,Y)
## Map projection
The World planishere used in this example adopts a modified azimuthal, equal-area projection that was the seventh in a series of new projections presented by Wagner in his cartographic work, called Wagner VII.
This was presented by Karlheinz Wagner (Germany) in 1941, the Wagner VII is a modification of the Hammer projection and is also known as the Hammer-Wagner projection.
Below a representation of the World using the Wagner VII projection.
From [http://www.giss.nasa.gov/tools/gprojector/help/projections.html](http://www.giss.nasa.gov/tools/gprojector/help/projections.html)
Obviously, the movement of the led panel strictly depends on the map projection used by the planishpere, and the inversion formula should be replaced in `code/main.py` file.
In the link below are reported formulas for all the Wagner projections inversion:
[http://www.boehmwanderkarten.de/kartographie/is_netze_wagner_123456789_inversions.html](http://www.boehmwanderkarten.de/kartographie/is_netze_wagner_123456789_inversions.html)
## References
* [Arduino Yùn](http://arduino.cc/en/Main/ArduinoBoardYun?from=Main.ArduinoYUN)
* [Google Analytics Real Time API](https://developers.google.com/analytics/devguides/reporting/realtime/v3/)
* [python-twitter](https://github.com/bear/python-twitter)
* [Wagner VII projection](http://www.mapthematics.com/ProjectionsList.php?Projection=188)