mirror of
https://github.com/m5stack/m5-docs.git
synced 2026-05-20 10:23:01 -07:00
156 lines
5.8 KiB
Markdown
156 lines
5.8 KiB
Markdown
# JOYSTICK
|
||
|
||
<el-tag effect="plain">SKU:U024</el-tag>
|
||
|
||
<div class="product_pic"><img src="assets/img/product_pics/unit/joystick/unit_joystick_01.webp"></div>
|
||
|
||
## Description
|
||
|
||
**JOYSTICK**, M5Stack has two types of JOYSTICKs: one is compatible with FACES Kit and this one, which is a M5Unit version of ther other **JOYSTICK** device.
|
||
|
||
JOYSTICK 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. Therefore, the entire Unit can output X-Y motion signals in both directions and Z direction.
|
||
|
||
Based on the schematic, the Joystick X dimension is connected to pin A0 of MEGA328, the Joystick Y dimension is connected to pin A1 on MEGA328, the Joystick Z dimension is connected to pin A2 on MEGA328.
|
||
|
||
<img src="assets/img/product_pics/unit/M5GO_Unit_joystick_02.webp" width="50%" height="50%">
|
||
|
||
This Unit communicates with the M5Core via the GROVE A interface. It's I2C address is 0x52. By reading the data transferred from JOSTICK, you can obtain the motion information of JOYSTICK.
|
||
|
||
## Product Features
|
||
|
||
- Output value of X, Y direction: 10 ~ 250
|
||
- Output value of Z direction is (0: released; 1: pressed)
|
||
- Software Development Platform : Arduino, UIFlow(Blockly, Python)
|
||
- Two Lego-compatible holes
|
||
|
||
## Include
|
||
|
||
- 1x JOYSTICK Unit
|
||
- 1x Grove Cable
|
||
|
||
## Applications
|
||
|
||
- Game Controller
|
||
- Robot remote control
|
||
|
||
|
||
## Specification
|
||
|
||
<table>
|
||
<tr style="font-weight:bold">
|
||
<td>Resources</td>
|
||
<td>Parameter</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Communication protocol</td>
|
||
<td>I2C：0x52</td>
|
||
</tr>
|
||
<tr>
|
||
<td>X、Y Axis output value range</td>
|
||
<td>10-250</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Z Axis output value range</td>
|
||
<td>0-1</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Net weight</td>
|
||
<td>11g</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Gross weight</td>
|
||
<td>27g</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Product Size</td>
|
||
<td>48*24*32mm</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Package Size</td>
|
||
<td>75*45*30mm</td>
|
||
</tr>
|
||
</table>
|
||
|
||
|
||
## EasyLoader
|
||
|
||
>EasyLoader is a concise and fast program writer, which has a built-in case program related to the product. It can be burned to the main control by simple steps to perform a series of function verification. Please install the corresponding driver according to the device type. M5Core host [Please click here to view the CP210X driver installation tutorial](en/arduino/arduino_development), M5StickC/V/T/ATOM series can be used without driver)
|
||
|
||
<div class="easyloader-box">
|
||
<div style="background-color:white;">
|
||
<div><img src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/image/easyloader_intro.webp"></div>
|
||
<div class="easyloader-btn">
|
||
<a href="https://m5stack.oss-cn-shenzhen.aliyuncs.com/EasyLoader/Windows/UNIT/For%20M5Core/EasyLoader_Joystick_UNIT_With_M5Core.exe">Windows</a>
|
||
<a href="https://m5stack.oss-cn-shenzhen.aliyuncs.com/EasyLoader/MacOS/UNIT/EasyLoader_Joystick_UNIT_With_M5Core.dmg">MacOS</a>
|
||
<!-- <a>Linux</a>
|
||
<a>MacOS</a> -->
|
||
</div>
|
||
</div>
|
||
<div>
|
||
<video id="example_video" controls>
|
||
<source src="https://m5stack.oss-cn-shenzhen.aliyuncs.com/video/Product_example_video/Unit/Joystick_UNIT.mp4" type="video/mp4">
|
||
</video>
|
||
<div class="easyloader-mask">
|
||
<a>
|
||
<svg id="play-btn" t="1583228776634" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="4152" width="75" height="75"><path d="M512 0C229.216 0 0 229.216 0 512s229.216 512 512 512 512-229.216 512-512S794.784 0 512 0z m0 928C282.24 928 96 741.76 96 512S282.24 96 512 96s416 186.24 416 416-186.24 416-416 416zM384 288l384 224-384 224z" p-id="4153" fill="#007aff"></path></svg></a>
|
||
<p>Description:</p>
|
||
<p>Show joystick XY data and button status.</p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
## PinMap
|
||
|
||
**Mega328 ISP**Download interface Pin foot definition
|
||
|
||
<img src="assets\img\product_pics\app\mega328_isp.webp" width="30%" height="30%">
|
||
|
||
<table>
|
||
<tr><td>M5Core(GROVE A)</td><td>GPIO22</td><td>GPIO21</td><td>5V</td><td>GND</td></tr>
|
||
<tr><td>JOYSTICK Unit</td><td>SCL</td><td>SDA</td><td>5V</td><td>GND</td></tr>
|
||
</table>
|
||
|
||
## Protocol
|
||
|
||
- Protocol type I2C
|
||
- I2C Address: **0x52**
|
||
|
||
```clike
|
||
/*--------------------------------------------------------------------------------------------------*/
|
||
| JOYSTICK REG | 0x52-0x54
|
||
| ------------------------------------------------------------------------------------------------
|
||
| joystick_x_reg[0] 0x52 | R | JOYSTICK X VALUE
|
||
| joystick_x_reg[1] 0x53 | R | JOYSTICK Y VALUE
|
||
| joystick_btn_reg[2] 0x54 | R | JOYSTICK BTN STATUS
|
||
/*----------------------------------------------------------------------------------------------------
|
||
```
|
||
|
||
## Schematic
|
||
|
||
<img src="assets/img/product_pics/unit/joystick_sch.webp">
|
||
|
||
## Example
|
||
|
||
### 1. Arduino
|
||
|
||
- [Click here to download the Arduino example](https://github.com/m5stack/M5Stack/tree/master/examples/Unit/JOYSTICK)
|
||
|
||
<img src="assets/img/product_pics/unit/unit_example/JOYSTICK/example_unit_joystick_04.webp">
|
||
|
||
### 2. UIFlow
|
||
|
||
- [Click here to download the UIFlow example](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Unit/JOYSTICK/UIFlow)
|
||
|
||
<img src="assets/img/product_pics/unit/unit_example/JOYSTICK/example_unit_joystick_03.webp">
|
||
|
||
<el-divider content-position="right">Last updated: 2020-12-11</el-divider>
|
||
|
||
<script>
|
||
|
||
var purchase_link = 'https://m5stack.com/collections/m5-unit/products/joystick-unit';
|
||
|
||
anchor_search(purchase_link);
|
||
scrollFunc();
|
||
|
||
</script>
|