> For the complete documentation index, see [llms.txt](https://gmii.gitbook.io/gmii-tw/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gmii.gitbook.io/gmii-tw/gmii-vision/device/arm/dobot-m1.md).

# Dobot M1

## 新增 M1

在裝置選單中選擇新增 M1，選取裝置連接埠後連線。

![](/files/-M2r6EPcUneiMrq8hbkD)

## 手臂控制器

* 鎖定：需先設定裝置編號後鎖定，才能在任務中使用。
* 控制：控制器中間區域為控制區，連接後可以控制和設定手臂。
* 警報：若操控有誤或是裝置出現故障，下方會顯示出警報資訊。

![](/files/-M2r6EPaPMEuhmZP4xVt)

## 在任務中使用手臂

Blockly和Python皆提供控制手臂的API，API的編號對應手臂控制器鎖定的編號，相同編號並且鎖定的手臂會執行對應的任務。

### Blockly 範例

![](/files/-M2r6EPbYS9FDJo7c2ZZ)

### Python 範例

```
from api import GmiiVisionAPI
import time

GmiiVisionSocket = GmiiVisionAPI.load()


i = None


while True:
  GmiiVisionAPI.DobotM1_SetPTPCommonParams(GmiiVisionSocket, 0, 100, 100)
  GmiiVisionAPI.DobotM1_SetPTPCmd(GmiiVisionSocket, 0, 0, [200, (-30), 50, 0])
  GmiiVisionAPI.DobotM1_WaitQueuedCmdCompleted(GmiiVisionSocket, 0)
  GmiiVisionAPI.DobotM1_SetPTPCommonParams(GmiiVisionSocket, 0, 30, 30)
  for i in range(1, 7):
    GmiiVisionAPI.DobotM1_SetPTPCmd(GmiiVisionSocket, 0, 7, [10, 10,  0, 0])
    GmiiVisionAPI.DobotM1_WaitQueuedCmdCompleted(GmiiVisionSocket, 0)
```