3. 小智的个性化方法

SiFli Technology2026/1/26大约 4 分钟

添加新的文件到小智工程

构建系统Scons简介

Scons是一个基于Python的开源构建系统，用于自动化软件构建过程。它使用Python脚本作为配置文件，允许开发者定义构建规则、依赖关系和目标文件。Scons的主要特点包括：

易于使用：Scons使用Python语言编写，易于学习和使用。
自动化依赖管理：Scons能够自动检测文件依赖关系，确保在构建过程中正确处理文件。
可扩展性：Scons支持自定义构建规则和工具，适应不同的项目需求。
跨平台支持：Scons可以在多个操作系统上运行，包括Windows、Linux和macOS。

小智工程Scons构建系统解析

小智工程使用Scons构建系统来自动化管理项目的编译过程。你只需要了解以下几个关键点：

核心文件结构

app/project/SConstruct：构建系统的入口文件，负责整体编译流程
app/project/SConscript：组织各个模块，指定哪些目录的代码需要编译
app/src/SConscript：定义应用源代码的编译规则

构建系统如何工作

Scons构建系统会按照以下流程自动编译项目：

SConstruct（入口）
    ↓
SConscript（收集各模块）
    ↓
├─ SDK核心库
├─ app/src（应用源代码）
├─ app/font（字体文件）
├─ app/asset（图片资源）
└─ app/peripherals（外设驱动）

编译生成的固件文件会输出到build_sf32lb52-xty-ai_hcpu目录下，包括：

main.bin：可下载到设备的二进制固件
download.bat：一键下载脚本

如何添加自己的C文件

最简单的方法：直接放到src目录

在app/src/SConscript中有这样一行代码：

src = Glob('*.c')

这行代码会自动收集app/src目录下的所有.c文件。所以你只需要：

创建你的C文件：在app/src目录下创建新的.c文件，例如my_function.c
编写代码：在文件中编写你的函数
重新编译：执行编译命令，新文件会自动被加入编译

示例：

# 工程目录结构
app/
  src/
    main.c              # 原有文件
    my_function.c       # 你新添加的文件
    xiaozhi_audio.c     # 原有文件
    ...

就这么简单！无需修改任何构建脚本，Scons会自动发现并编译新添加的C文件。

如果需要添加子目录的文件：

如果你想在app/src下创建子目录来组织代码，需要在app/src/SConscript中添加对应的规则：

src = Glob('*.c')
src = src + Glob('./my_module/*.c')  # 添加子目录

添加头文件路径：

如果需要添加新的头文件搜索路径，在app/src/SConscript中修改CPPPATH：

CPPPATH = [cwd, cwd + '/my_include']

如何添加src以外目录的文件

如果你想在app目录下创建一个全新的目录来存放代码（而不是放在src中），需要进行以下步骤：

步骤1：创建新目录和文件

例如，创建一个app/my_driver目录：

app/
  my_driver/
    my_sensor.c
    my_sensor.h

步骤2：在新目录中创建SConscript文件

在app/my_driver目录下创建SConscript文件，内容如下：

# app/my_driver/SConscript
from building import *

cwd = GetCurrentDir()
src = Glob('*.c')              # 收集所有C文件
CPPPATH = [cwd]                # 添加当前目录到头文件搜索路径

group = DefineGroup('MyDriver', src, depend = [''], CPPPATH = CPPPATH)

Return('group')

步骤3：在项目SConscript中引入新目录

修改app/project/SConscript，添加新目录的编译规则：

# app/project/SConscript
# ... 原有代码 ...

# 添加应用源代码
objs.extend(SConscript(cwd+'/../src/SConscript', variant_dir="src", duplicate=0))

# 添加你的新目录
objs.extend(SConscript(cwd+'/../my_driver/SConscript', variant_dir="my_driver", duplicate=0))

# 字体自动转换
objs.extend(SConscript(cwd+'/../font/SConscript', variant_dir="font", duplicate=0))
# ... 其他模块 ...

步骤4：重新编译

执行编译命令，新目录中的文件就会被编译到固件中。

要点说明：

variant_dir参数指定编译输出目录的名称，通常与源目录名称相同
duplicate=0表示不复制源文件，直接在原位置编译
DefineGroup的第一个参数是组名，可以任意命名
CPPPATH用于添加头文件搜索路径，这样其他文件就可以#include你的头文件

添加一个内部mcp服务

以添加一个a * b 的mcp服务为例，步骤如下：

步骤1：创建服务文件
在app/src/mcp目录下创建mcp_multiply.cc和mcp_multiply.h文件。
![image]

步骤2：编写服务代码
在mcp_multiply.cc中实现服务逻辑：

#include "mcp_server.h"

ReturnValue CalculateSum(const PropertyList& properties) {
    int a = properties["a"].value<int>();
    int b = properties["b"].value<int>();
    return a + b;
}

在mcp_multiply.h中定义服务接口：

#ifndef MCP_MULTIPLY_H
#define MCP_MULTIPLY_H
#include "mcp_server.h"
ReturnValue CalculateSum(const PropertyList& properties);
#endif // MCP_MULTIPLY_H

在mcp_server.cc中注册服务：


void mcp_server_init(void) {
    
    AddTool("self.interrupt.get_status",
        "Get the current status of the interrupt function.",
        PropertyList(),
        [=](const PropertyList&) -> ReturnValue 
        {
            // 注意：vad_enable为1表示不打断，为0表示可打断
            return (bool)(!vad_enable);
        });
#endif   

    AddTool("self.mcp.calculate",
    "Calculate the multiplication of two numbers.",
    PropertyList({
        Property("a", kPropertyTypeInteger, 0, 114514),
        Property("b", kPropertyTypeInteger, 0, 1919810)
    }),
    CalculateSum);
    // Restore the original tools list to the end of the tools list
    tools_.insert(tools_.end(), original_tools.begin(), original_tools.end());
}

步骤3：重新编译
执行编译命令，新的mcp服务就会被包含在固件中。重新下载固件到设备后，你就可以通过mcp客户端调用这个乘法服务了。这时候你就可以问小智：

"114 乘以 514 等于多少？"

如果一切顺利，它会返回正确的结果58596。