Seeed 101020028 User manual

1
Grove - Thumb Joystick
Version：1.0
Release date：9/20/2015
Wiki: http://www.seeedstudio.com/wiki/Grove_-_Thumb_Joystick
Bazaar: http://www.seeedstudio.com/depot/Grove-Thumb-Joystick-p-935.html

2
Document Revision History
Revision
Date
Author
Description
1.0
Sep 21, 2015
Victor.He
Create file

3
Contents
Document Revision History···································································································2
1. Introduction ···················································································································2
2. Features··························································································································3
3. Application ideas············································································································4
4. Specifications ·················································································································5
5. Usage······························································································································6
5.1 With Arduino····················································································································· 6
5.2 With Raspberry Pi ············································································································· 7
6. Resources ·····················································································································10
7. Support·························································································································11

1
Disclaimer
For physical injuries and possessions loss caused by those reasons which are not related to product quality,
such as operating without following manual guide, natural disasters or force majeure, we take no
responsibility for that.
Under the supervision of Seeed Technology Inc., this manual has been compiled and published which
covered the latest product description and specification. The content of this manual is subject to change
without notice.
Copyright
The design of this product (including software) and its accessories is under tutelage of laws. Any action to
violate relevant right of our product will be penalized through law. Please consciously observe relevant local
laws in the use of this product.

2
1. Introduction
Grove - Thumb Joystick is a Grove compatible module which is very similar to the 'analog' joystick on PS2
(PlayStation 2) controllers. The X and Y axes are two ~10k potentiometers which control 2D movement by
generating analog signals. The joystick also has a push button that could be used for special applications.
When the module is in working mode, it will output two analog values, representing two directions.
Compared to a normal joystick, its output values are restricted to a smaller range (i.e. 200~800), only when
being pressed that the X value will be set to 1023 and the MCU can detect the action of pressing.

3
2. Features
Grove Interface
5V/3.3V Compatible
Analog Output

4
3. Application ideas
Game Controller
Robot remote

5
4. Specifications
Item
Min
Typical
Max
Unit
Working Voltage
4.75
5.0
5.25
V
Output Analog Value （X coordinate）
206
516
798
\
Output Analog Value （Y coordinate）
203
507
797
\

6
5. Usage
5.1 With Arduino
The Grove - Thumb Joystick is an analog device that outputs analog signal ranging from 0 to 1023. That
requires us to use the analog port of Arduino to take the readings.
1. Connect the module to the A0/A1 of Grove - Basic Shield using the 4-pin grove cable.
2. Plug the Grove - Basic Shield into Arduino.
3. Connect Arduino to PC by using a USB cable.
4. Copy and paste code below to a new Arduino sketch. Please click here if you do not know how to upload.
/*
Thumb Joystick demo v1.0
by:http://www.seeedstudio.com
connect the module to A0&A1 for using;
*/
void setup() {
Serial.begin(9600);
}
void loop() {

7
int sensorValue1 =analogRead(A0);
int sensorValue2 =analogRead(A1);
Serial.print("The X and Y coordinate is:");
Serial.print(sensorValue1,DEC);
Serial.print(",");
Serial.println(sensorValue2,DEC);
Serial.println(" ");
delay(200);
5. You can check the values of the output analog signals by opening the Serial Monitor.
The output value from the analog port of Arduino can be converted to the corresponding resistance using
the formula:R=(float)(1023-sensorValue)*10/sensorValue.
5.2 With Raspberry Pi
1. You should have got a raspberry pi and a grovepi or grovepi+.
2. You should have completed configuring the development environment, otherwise follow here.
3. Connection. Plug the sensor to grovepi socket D4 by using a grove cable.
4. Navigate to the demos' directory:
cd yourpath/GrovePi/Software/Python/
To see the code