Skip to content

Commit 423654a

Browse files
committed
chores 调整lint
1 parent 7cffcb0 commit 423654a

File tree

5 files changed

+47
-45
lines changed

5 files changed

+47
-45
lines changed

.markdownlint.jsonc

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
{
22
"no-reversed-links": false,
33
"line-length": false,
4-
"no-inline-html": false
4+
"no-inline-html": false,
5+
"first-line-h1": false
56
}

docs/xrobot/faq/faq.md

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,10 @@ title: Q & A
66

77
可通过点击以下链接进行下载,七牛灵芯云提供最新版本的设备固件:
88

9-
| 芯片 | 固件 |
10-
| :------- | :------------------------------------------------------------------------------------------------------------------------------ |
11-
| ESP32-C3 | https://algorithm.qnaigc.com/xiaoling-rom/xiaoling-202507021613-ESP32C3-xiage_mini_c3-nihaoxiaozhi-without_dns.bin |
12-
| ESP32-S3 | https://algorithm.qnaigc.com/xiaoling-rom/xiaoling-202507021613-ESP32S3-bread_compact-nihaoxiaozhi_nihaoxiaoxin-without_dns.bin |
9+
| 芯片 | 固件 |
10+
| :------- | :-------------------------------------------------------------------------------------------------------------------------------- |
11+
| ESP32-C3 | <https://algorithm.qnaigc.com/xiaoling-rom/xiaoling-202507021613-ESP32C3-xiage_mini_c3-nihaoxiaozhi-without_dns.bin> |
12+
| ESP32-S3 | <https://algorithm.qnaigc.com/xiaoling-rom/xiaoling-202507021613-ESP32S3-bread_compact-nihaoxiaozhi_nihaoxiaoxin-without_dns.bin> |
1313

1414
## 2. 烧录固件时提示串口被占用?
1515

@@ -27,13 +27,11 @@ title: Q & A
2727

2828
如果设备固件版本>=0.2.2,在重试 3 次连接原有 WI-FI 网络失败后,会重新进入配网模式(切换网络时可能需要按 RST 按键重启一下设备)。如果设备固件版本较新,在设备开机后,如果处于扫描 wifi 状态时按一下 boot 键(如图中绿圈所示),设备将重新配网,不再连接上次的 WIFI 网络。
2929

30-
| 芯片 | 说明图片 |
31-
| -------- | ------------------------------------------------- |
32-
| ESP32-C3 | <img src="../device/imgs/device-intro/3.2 esp32-c3.png"/> |
33-
| ESP32-S3 | <img src="../device/imgs/device-intro/3.2 esp32-s3.png"/> |
30+
| 芯片 | 说明图片 |
31+
| -------- | ----------------------------------------------------------- |
32+
| ESP32-C3 | <img src="./imgs/faq/3.2 esp32-c3.png" alt="3.2 esp32-c3"/> |
33+
| ESP32-S3 | <img src="./imgs/faq/3.2 esp32-s3.png" alt="3.2 esp32-s3"/> |
3434

3535
## 6. 智能体更新角色配置后未生效?
3636

3737
智能体更新角色配置后,需重启设备才能生效。
38-
39-
1.91 MB
Loading
2.28 MB
Loading

docs/xrobot/platform/others/device/device-intro.md

Lines changed: 37 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -29,55 +29,58 @@ title: 设备使用指南
2929

3030
bin 固件烧录后,设备保持接通电源状态,重启设备,设备进入配网模式。
3131

32-
| 芯片 | 说明图片 |
33-
| ---------------------------------------- | -------------------------------------------------- |
34-
| ESP32-C3(将红圈所示的开关关闭后再打开) | <img src="./imgs/device-intro/3.1 esp32-c3.png" /> |
35-
| ESP32-S3(按一下红圈所示的 RST 按钮) | <img src="./imgs/device-intro/3.1 esp32-s3.png" /> |
32+
| 芯片 | 说明图片 |
33+
| ---------------------------------------- | --------------------------------------------------------------------- |
34+
| ESP32-C3(将红圈所示的开关关闭后再打开) | <img src="./imgs/device-intro/3.1 esp32-c3.png" alt="3.1 esp32-c3" /> |
35+
| ESP32-S3(按一下红圈所示的 RST 按钮) | <img src="./imgs/device-intro/3.1 esp32-s3.png" alt="3.1 esp32-s3" /> |
3636

3737
### 2)重新配网
3838

3939
如果设备固件版本>=0.2.2,在重试 3 次连接原有 WI-FI 网络失败后,会重新进入配网模式(切换网络时可能需要按 RST 按键重启一下设备)。如果设备固件版本较新,在设备开机后,如果处于扫描 wifi 状态时按一下 boot 键(如图中绿圈所示),设备将重新配网,不再连接上次的 WIFI 网络。
4040

41-
| 芯片 | 说明图片 |
42-
| -------- | ------------------------------------------------- |
43-
| ESP32-C3 | <img src="./imgs/device-intro/3.2 esp32-c3.png"/> |
44-
| ESP32-S3 | <img src="./imgs/device-intro/3.2 esp32-s3.png"/> |
41+
| 芯片 | 说明图片 |
42+
| -------- | -------------------------------------------------------------------- |
43+
| ESP32-C3 | <img src="./imgs/device-intro/3.2 esp32-c3.png" alt="3.2 esp32-c3"/> |
44+
| ESP32-S3 | <img src="./imgs/device-intro/3.2 esp32-s3.png" alt="3.2 esp32-s3"/> |
4545

4646
### 3)配网步骤
4747

4848
## 3.1. 使用小程序配网
4949

50-
### 1)小程序二维码
50+
### 1)小程序二维码
5151

52-
<img src="./imgs/device-intro/qrcode.png" class="img-center"/>
52+
<img src="./imgs/device-intro/qrcode.png" class="img-center" alt="qrcode"/>
5353

5454
### 2)扫码进入配网小程序
5555

5656
## 3.1.a IOS/苹果设备
5757

5858
1. 搜寻设备热点,在 IOS 「设置->无线局域网」 页面搜寻到设备热点后返回小程序继续操作。
5959

60-
| <img src="./imgs/device-intro/3.1.1-1.png"/> | <img src="./imgs/device-intro/3.1.1-2.png"/> | <img src="./imgs/device-intro/3.1.1-3.png"/> |
61-
| -------------------------------------------- | -------------------------------------------- | -------------------------------------------- |
60+
| <img src="./imgs/device-intro/3.1.1-1.png" alt="3.1.1-1"/> | <img src="./imgs/device-intro/3.1.1-2.png" alt="3.1.1-2"/> | <img src="./imgs/device-intro/3.1.1-3.png" alt="3.1.1-3"/> |
61+
| ---------------------------------------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------- |
6262

6363
2. 连接设备热点。
6464

65-
| <img src="./imgs/device-intro/3.1.1-4.png"/> | <img src="./imgs/device-intro/3.1.1-5.png"/> |
66-
| -------------------------------------------- | -------------------------------------------- |
65+
| <img src="./imgs/device-intro/3.1.1-4.png" alt="3.1.1-4"/> | <img src="./imgs/device-intro/3.1.1-5.png" alt="3.1.1-5"/> |
66+
| ---------------------------------------------------------- | ---------------------------------------------------------- |
6767

6868
3. 配置 wifi。
69-
| <img src="./imgs/device-intro/3.1.1-6.png"/> | <img src="./imgs/device-intro/3.1.1-7.png"/> | <img src="./imgs/device-intro/3.1.1-8.png"/> |
70-
| -------------------------------------------- | -------------------------------------------- | -------------------------------------------- |
69+
70+
| <img src="./imgs/device-intro/3.1.1-6.png" alt="3.1.1-6"/> | <img src="./imgs/device-intro/3.1.1-7.png" alt="3.1.1-7"/> | <img src="./imgs/device-intro/3.1.1-8.png" alt="3.1.1-8"/> |
71+
| ---------------------------------------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------- |
7172

7273
## 3.1.b 安卓设备
7374

7475
1. 搜寻设备热点,并连接。
75-
| <img src="./imgs/device-intro/3.1.2-1.png"/> | <img src="./imgs/device-intro/3.1.2-2.png"/> | <img src="./imgs/device-intro/3.1.2-3.png"/> |
76-
| -------------------------------------------- | -------------------------------------------- | -------------------------------------------- |
76+
77+
| <img src="./imgs/device-intro/3.1.2-1.png" alt="3.1.2-1"/> | <img src="./imgs/device-intro/3.1.2-2.png" alt="3.1.2-2"/> | <img src="./imgs/device-intro/3.1.2-3.png" alt="3.1.2-3"/> |
78+
| ---------------------------------------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------- |
7779

7880
2. 配置 wifi。
79-
| <img src="./imgs/device-intro/3.1.2-4.png"/> | <img src="./imgs/device-intro/3.1.2-5.png"/> | <img src="./imgs/device-intro/3.1.2-6.png"/> |
80-
| -------------------------------------------- | -------------------------------------------- | -------------------------------------------- |
81+
82+
| <img src="./imgs/device-intro/3.1.2-4.png" alt="3.1.2-4"/> | <img src="./imgs/device-intro/3.1.2-5.png" alt="3.1.2-5"/> | <img src="./imgs/device-intro/3.1.2-6.png" alt="3.1.2-6"/> |
83+
| ---------------------------------------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------- |
8184

8285
## 3.2. 浏览器登录
8386

@@ -87,28 +90,28 @@ bin 固件烧录后,设备保持接通电源状态,重启设备,设备进
8790

8891
选中并连接, 使用浏览器地址栏输入网址 <http://192.168.4.1> 进入设备的网络配置页面,如下图示(截图以 Iphone 为例):
8992

90-
| <img src="./imgs/device-intro/3.2-1.png"/> | <img src="./imgs/device-intro/3.2-2.png"/> |
91-
| ------------------------------------------ | ------------------------------------------ |
93+
| <img src="./imgs/device-intro/3.2-1.png" alt="3.2-1"/> | <img src="./imgs/device-intro/3.2-2.png" alt="3.2-2"/> |
94+
| ------------------------------------------------------ | ------------------------------------------------------ |
9295

9396
2. 配置 WiFi
9497

9598
选择 WiFi 网络,选择名称后会自动填写(也可手动录入)。在密码输入框中输入当前选择的 wifi 密码,点击 连接 按钮提交即可(如果是手机已经保存过的密码会自动提交)。
9699

97-
| <img src="./imgs/device-intro/3.2-3.png"/> | <img src="./imgs/device-intro/3.2-4.png"/> |
98-
| ------------------------------------------ | ------------------------------------------ |
100+
| <img src="./imgs/device-intro/3.2-3.png" alt="3.2-3"/> | <img src="./imgs/device-intro/3.2-4.png" alt="3.2-4"/> |
101+
| ------------------------------------------------------ | ------------------------------------------------------ |
99102

100103
3. 配置 OTA 地址
101104

102105
点击高级选项,输入该 OTA 地址后点击保存:<https://xrobo.qiniuapi.com/v1/ota/>
103106

104-
<img src="./imgs/device-intro/3.2-5.png" width=50% class="img-center"/>
107+
<img src="./imgs/device-intro/3.2-5.png" width=50% class="img-center" alt="3.2-5"/>
105108

106109
4. 连接并重启设备
107110

108111
连接可能需要耗费 5 秒,请耐心等待,连接成功后设备将重启。重启后设备已经连上 wifi 网络,如果 wifi 不可用,重新配网。
109112

110-
| <img src="./imgs/device-intro/3.2-6.png"/> | <img src="./imgs/device-intro/3.2-7.png"/> |
111-
| ------------------------------------------ | ------------------------------------------ |
113+
| <img src="./imgs/device-intro/3.2-6.png" alt="3.2-6"/> | <img src="./imgs/device-intro/3.2-7.png" alt="3.2-7"/> |
114+
| ------------------------------------------------------ | ------------------------------------------------------ |
112115

113116
## 4. 添加新设备到 [七牛云灵芯平台](https://xrobo.qiniu.com/)
114117

@@ -120,35 +123,35 @@ bin 固件烧录后,设备保持接通电源状态,重启设备,设备进
120123

121124
注意:如果用户没有听到语音播报,喇叭没有发声,面包板方案用户请检查功放和喇叭接线是否正常,使用第三方开发板用户请检查固件是否匹配且正常运行。
122125

123-
电脑浏览器访问 七牛云灵芯平台-控制面板 后台:https://xrobo.qiniu.com/ ,如未注册请先注册账号。
126+
电脑浏览器访问 七牛云灵芯平台-控制面板 后台:<https://xrobo.qiniu.com/> ,如未注册请先注册账号。
124127

125128
### 第一步:注册账号
126129

127-
<img src="./imgs/device-intro/4-1.png" width=50% class="img-center"/>
130+
<img src="./imgs/device-intro/4-1.png" alt="4-1" width=50% class="img-center"/>
128131

129132
### 第二步:创建智能体
130133

131134
智能体名称用户随意。
132135

133-
<img src="./imgs/device-intro/4-2.png" width=50% class="img-center"/>
136+
<img src="./imgs/device-intro/4-2.png" alt="4-2" width=50% class="img-center"/>
134137

135138
新建智能体完成后,出现在智能体列表中,如下图示:
136139

137-
<img src="./imgs/device-intro/4-3.png" width=50% class="img-center"/>
140+
<img src="./imgs/device-intro/4-3.png" alt="4-3" width=50% class="img-center"/>
138141

139142
### 第三步:配置角色
140143

141144
提供了集中角色模板,也可以设置您自己的角色,通过修改“角色介绍”中的说明。
142145

143-
<img src="./imgs/device-intro/4-4.png" class="img-center"/>
146+
<img src="./imgs/device-intro/4-4.png" alt="4-4" class="img-center"/>
144147

145148
### 第四步:添加新设备
146149

147150
首先获得 6 位设备 ID,配网重启后设备自动产生,如果设备已经绑定智能体则需要先解绑,再通过设备 RTS 键重启获得。
148-
<img src="./imgs/device-intro/4-5.png" class="img-center"/>
151+
<img src="./imgs/device-intro/4-5.png" alt="4-5" class="img-center"/>
149152

150153
已经添加过设备:请点击对应智能体模块下方 “设备管理” 进入设备列表页面,再通过右侧 “+添加设备” 按钮添加新设备,如下图示:
151-
<img src="./imgs/device-intro/4-6.png" class="img-center"/>
154+
<img src="./imgs/device-intro/4-6.png" alt="4-6" class="img-center"/>
152155

153156
设备添加后将自动激活,并显示在“设备管理”列表页面上,如上图示,就可以正常使用了。
154157

0 commit comments

Comments
 (0)