> For the complete documentation index, see [llms.txt](https://sharinghub.kittenbot.hk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sharinghub.kittenbot.hk/functional_modules/sugar/joystick.md).

# Sugar 搖桿模組

![](https://kittenbothk.readthedocs.io/en/latest/_images/joy1.png)

這是一隻搖桿模組，可以檢測X和Y的數值，亦可以檢測按下狀態。背後亦設有塑膠積木孔，可以完美配搭塑膠積木使用。

### 產品參數

* 尺寸：24 x 24 x 23 mm
* 重量：7g
* 訊號：I2C
* 類型：I2C 模組
* X: -255\~255
* Y: -255\~255
* 按鍵: 0\~1

### 產品接線

#### Robotbit Edu

用4Pin 連接線將模組連接到Robotbit Edu的藍色4Pin接口。

![](https://kittenbothk.readthedocs.io/en/latest/_images/joy_wire.png)

#### Robotbit 2.2

用4Pin 連接線將模組連接到Robotbit 2.2的I2C接口。

<figure><img src="/files/8FE1hivcXXp8k0Hy5V2Y" alt=""><figcaption></figcaption></figure>

### 編程教學

### MakeCode編程教學

![](https://kittenbothk.readthedocs.io/en/latest/_images/mcbanner15.png)

#### 加載Sugar插件：

#### 在擴展頁直接搜尋sugar (sugar已經過微軟認證，可以直接搜尋)

![](https://kittenbothk.readthedocs.io/en/latest/_images/sugar_search.gif)

#### 你亦可以用插件地址搜尋

Sugar插件：<https://github.com/KittenBot/pxt-sugar>

#### [詳細方法](/programmingplatforms/makecode/kittenbotandmakecode.md)

{% embed url="<https://makecode.microbit.org/_CcJ5YTdF2795>" %}

[參考程式](https://makecode.microbit.org/_CcJ5YTdF2795)

#### Kittenblock 編程教學

![](https://kittenbothk.readthedocs.io/en/latest/_images/kbbanner9.png)

![](https://kittenbothk.readthedocs.io/en/latest/_images/joy3.png)

#### MicroPython 編程教學

```
JoyStick()
value(dir)
state()
```

* dir: X/Y
* state(): 默認返回none，按下時根據狀態返回pressed，left，right，up，down

參考程式

```
from future import *
from sugar import *

joystick = JoyStick()
screen.sync = 0

while True:
    screen.fill((0, 0, 0))
    screen.text(str("X: ")+str(joystick.value('x')), x = 5, y = 10)
    screen.text(str("Y: ")+str(joystick.value('y')), x = 5, y = 30)
    if joystick.state() == 'pressed':
        screen.text("Pressed", x = 5, y = 50)
    screen.refresh()
```