1. GomerX SDK 开始使用SDK

1.1. SDK 能做什么?

GomerX SDK （以下简称 SDK）是一套面向 GomerX 系列产品的开发工具包，目前支持的产品包括。通过 SDK，用户可以实现在PC上控制机器人运动以及获取机器人传感器的相关信息

1.2. 第一个SDK程序

接下来本文档将从如何获取 GomerX 机器人的相关信息来编写第一个 SDK 程序3

首先在GOMERX-SDK-MASTER目录下新建一个文件夹usr，用于保存用户自己的程序代码
然后打开VScode，点击文件-新建文件，并保存为py后缀格式的python文件，命名myrobot.py

打开myrobot.py文件，开始编写程序
从安装的的 gomerx 包中导入自己需要的模块，这里我们导入包含获取机器人信息的 robot 模块:
```
from gomerx import robot
```
接下来先定义一个 robot_name 变量来存放机器人的名字，并实例化一个机器人对象:
```
robot_name = 'GomerX_6e09ba'
my_robot = robot.Robot(robot_name)
```
通过 robot 模块中的 get_version 方法可以得到机器人的版本,并通过print函数打印出来:
```
version = my_robot.get_version()
print("Robot Version: ", version)
```
通过 robot 模块中的 get_sn 方法可以得到机器人的 sn 号,并通过print函数打印出来:
```
sn = my_robot.get_sn()
print("Robot SN: ", sn)
```
通过 robot 模块中的 get_battery 方法可以得到机器人的剩余电量,并通过print函数打印出来:
```
battery = my_robot.get_battery()
print("Robot Battery: ", battery)
```

示例文档中提供了获取机器人相关信息的例程 /examples/00_basic/02_robot_info.py

from gomerx import robot

if __name__ == '__main__':
    # robot_name = input('Please input robot name: ')
    robot_name = 'GomerX_UyeoyW'
    my_robot = robot.Robot(robot_name)
    version = my_robot.get_version()
    print("Robot Version: ", version)
    sn = my_robot.get_sn()
    print("Robot SN: ", sn)
    battery = my_robot.get_battery()
    print("Robot Battery: ", battery)

1.3. 运行编写的程序

接下来本文档将演示如何使用 SDK ，并运行编写的程序

在终端面板输入, 将我们的终端切换到当前程序的路径下:

cd .\examples\00_basic\
-- cd 切换目录
-- dir或ls显示当前目录文件
-- cd.. 回到上层目录

使用 python 运行示例程序:
```
python .\01_sdk_version.py
```

../_images/win10_use_SDK_examples_setup1.png

2. 结束运行程序 - 关闭终端可以结束运行程序 - 部分程序中按Esc可以结束运行程序

1.4. 示例程序讲解

更多的示例程序路径为 /gomerx-sdk/examples
示例程序包含了主要的功能展示

00_basic 基础功能

01_motion 电机运动与机械臂运动相关

02_led 小车前方LED灯控制

03_camera 小车摄像头控制

04_skill 人脸检测、字母数字识别、巡线检测等人工智能程序

05_opencv 读取保存图像与图形绘制

06_project 果小智配套智慧医院主题套件完整示例程序