Getting Started

如果您是AIOS系列执行器的新手，以下说明旨在帮助您快速入门和运行。

开箱

当您收到产品后，通常会包含以下几个配件：

hardware

AIOS执行器
电源连接线
网线
开关电源适配器
AMBER控制盒
Linux嵌入式计算机(Raspberry Pi)

将执行器连接到网络

对于通信延迟和稳定性要求比较高的场合建议采用全部有线网络连接（Loopback通信延时可以降至4ms以下），当采用无线连接时，通信延迟将大于10ms（具体根据环境而定)

有线网络连接

AIOS执行器一般具备一个或两个网口，将其中一个网口通过网线连接到Raspberry Pi。若AIOS执行器上有两个网口，则可以通过这两个网口进行执行器的级联。连接好网线后，接通Raspberry Pi的电源（系统需要预先启动完毕），接通执行器的电源，看到执行器信号灯开始紫色的快速呼吸闪烁，说明其正在连接有线网络，若连接成功，信号灯便会开始紫色慢闪烁。若分配IP失败，10s后便会进入无线网络连接，闪烁的颜色也会由紫色快闪变为蓝色快闪。

通常，第一次连接会连接失败，此时可重新给执行器上电，在经过一次重启后，都能够顺利连接到有线网络

AIOS_wired_connection

有线连接成功后，通过以下命令进入AIOS的Python工具文件夹：

cd aios_python_example/

请确保执行器输出侧没有连接任何负载！！！

运行以下命令，执行器便开始执行演示动作：

python3 first_demo.py

无线网络连接

无线网络的SSID和密码需要通过Python脚本在有线连接下进行配网设置。首先需要将执行器通过有线方式连接至树莓派网口，带执行器获取IP后，通过以下命令进入AIOS的Python工具文件夹：

cd aios_python_example/

nano network_setting.py

编辑如下代码中的'SSID'和'password'字段内容：

for i in range(len(Server_IP_list)):
    dict = {
        'DHCP_enable' : True,
        'SSID' : 'wifi-name',
        'password' : 'wifi-password',
        'staticIP' : [192,168,100,i+10],
        'gateway' : [192,168,100,1],
        'subnet' : [255,255,255,0],
        'dns_1' : [114,114,114,114],
        'dns_2' : [8,8,8,8]
    }

然后保存退出，运行：

python3 network_setting.py

成功后会返回：

Send JSON Obj: {"method": "SET", "reqTarget": "/network_setting", "DHCP_enable": true, "SSID": "wifi-name", "password": "wifi-password"}
Server received from ('10.0.0.17', 2334):{"status":"OK","reqTarget":"/network_setting"}

到此，执行器的WIFI配网设置成功。拔掉网线，重新给执行器上电，10秒种后，开始由紫色快闪变为蓝色快闪，连接成功后变为蓝色慢闪，此时成功接入无线网络。

AIOS_wireless_connection

连接电源并通过AMBER Actuator Studio控制执行器

连接电源适配器到AIOS，接通市电，顺时针旋转急停开关给AIOS上电。若指示灯正确闪烁，启动AMBER Actuator Studio界面进行执行器的调试、配置、控制等操作。

AMBER_Studio_01

请勿热插拔模块。接通电源时连接和断开电源会引起火花，并可能损坏模块。仅在电源关闭时连接和断开电源连接器。

指示灯状态说明

	闪烁模式	含义
1	快速紫色呼吸闪烁	有线以太网连接中
2	慢速紫色呼吸闪烁	有线以太网连接成功
3	快速青蓝色呼吸闪烁	WIFI连接中
4	慢速青蓝色呼吸闪烁	WIFI连接成功
5	快速红色呼吸闪烁	执行器错误
6	快速翠绿色呼吸闪烁	OTA升级中
7	快速橙色呼吸闪烁	寻找执行器