# 小智机器人

**Repository Path**: shangguan-lewan-pai/xiaozhi-robot

## Basic Information

- **Project Name**: 小智机器人
- **Description**: 上官乐玩派移植小智机器人
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-17
- **Last Updated**: 2025-12-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: xiaozhi

## README

# 小智机器人适配

### 介绍

[XiaoZhi AI - 小智AI](https://xiaozhi.me/)，**小智机器人**是一款开源的语音陪伴型机器人开源项目，本项目实现对该开源项目的适配。

上官乐玩派移植小智机器人

### 软件环境

小智机器人项目版本 `v1.6.2`
IDF版本`V5.3.1`

### 添加上官乐玩派至项目

1.首先下载github上的项目源码`[Source code (zip)](https://github.com/78/xiaozhi-esp32/archive/refs/tags/v1.6.2.zip)`[Release v1.6.2 · 78/xiaozhi-esp32](https://github.com/78/xiaozhi-esp32/releases/tag/v1.6.2)

![1765954033740](images/README/1765954033740.png)

2.解压`xiaozhi-esp32-1.6.2.zip`后使用`VsCode`打开该项目文件夹

![1765954216245](images/README/1765954216245.png)

3.在 [main/CMakeList.txt](main/CMakeList.txt)内添加上官乐玩派信息

```
elseif(CONFIG_BOARD_TYPE_SHANGGUAN_LEWANPAI)
    set(BOARD_TYPE "shangguan-lewanpai")
    set(BUILTIN_TEXT_FONT font_puhui_basic_30_4)
    set(BUILTIN_ICON_FONT font_awesome_30_4)
    set(DEFAULT_EMOJI_COLLECTION twemoji_64)
```

![1765954607081](images/README/1765954607081.png)

4.在 [main/Kconfig.projbuild](main/Kconfig.projbuild)内添加上官乐玩派信息

```
config BOARD_TYPE_SHANGGUAN_LEWANPAI
        bool "上官乐玩派"
	depends on IDF_TARGET_ESP32S3
```

![1765954658725](images/README/1765954658725.png)

### 添加上官乐玩派板级适配

1.在 [main/boards](main/boards)内创建文件夹`shangguan-lewanpai`，并依次创建以下文件，可从其他开发板如[main/boards/esp32-s3-touch-lcd-3.5](main/boards/esp32-s3-touch-lcd-3.5)`内复制过来进行修改：

* `board_control.cc`： 机器人控制接口，可以在此添加相应的控制逻辑
* `config.h`：系统IO使用定义
* `config.json`：板载项目配置
* `shangguan-lewanpai.cc` ：上官乐玩派的硬件调用入口

![1765956520532](images/README/1765956520532.png)

2.将原先`esp32-s3-touch-lcd-3.5.cc`改名为`shangguan-lewanpai.cc`,并剔除不需要的部分，如`TCA9954`和`AXP2101`等相关的驱动代码及对象。
涉及的对象`pmic_`等都需要去除，引用的值如

```
charging = pmic_->IsCharging(); //改为  charging = true;
discharging = pmic_->IsDischarging();//改为 discharging = false;
```

3.在 [shangguan-lewanpai/config.json](main/boards/shangguan-lewanpai/config.json)内修改为：

```
{
    "target": "esp32s3",
    "builds": [
        {
            "name": "shangguan-lewanpai",
            "sdkconfig_append": []
        }
    ]
}
```

4.在 [shangguan-lewanpai/config.h](main/boards/shangguan-lewanpai/config.h)进行引脚适配，引脚定义可从之前上官乐玩派历程的 `example_code/component`中找到

![1765955482954](images/README/1765955482954.png)

5.点击打开底部工具栏`齿轮`，打开sdkconfig配置，在左侧栏选中`Xiaozhi Assistant`，右侧栏`Board Type`中选中`上官乐玩派`，后保存，编译，烧录镜像

![1765956282972](images/README/1765956282972.png)

6.成功烧录后，开发板会启动，进入到WiFi配置模式，需要配置可以连接互联网的WIFI

* 电脑WiFi需要连接到小智的热点`xiaozhi-xxxx`
* 浏览器打开`192.168.4.1`
* 选中可以底下可以连接的WIFI名称，并输入相应密码，保存后等待系统重启，自动连接WIFI

![1765956652169](images/README/1765956652169.png)

### 后台添加、绑定设备

1.开发板连接WIFI后，屏幕会显示当前的`绑定码`，并且进行语音播报。

![1765956367384](images/README/1765956367384.png)

2.浏览器打开[智能体管理 - 小智AI官网](https://xiaozhi.me/console/agents)，点击添加设备，并输入屏幕显示的`绑定码`，使用开源版协议即可。

![1765956793630](images/README/1765956793630.png)

3.最后能在管理设备内查看到自己的接入设备，也可进行其他配置。