Aspen系统机器人配置项清单

本清单基于Aspen系统核心功能模块划分，覆盖设备标识、网络连接、时间同步、功能控制、安全认证、日志运维六大维度，包含字段格式、配置示例、用途说明及注意事项，适用于扫地机器人、服务机器人等IoT设备。

一、基础信息配置（设备身份与硬件关联）

配置字段	格式规范	配置示例	核心用途	注意事项
aspen.rbt_name	字母+数字+下划线（≤32位）	aspen.rbt_name=VTORoomba_Living	定义机器人名称，用于APP/云端识别	不可包含特殊字符（如!@#），多设备需唯一
aspen.rbt_model	品牌+型号（固定枚举）	aspen.rbt_model=iRobot_RoombaJ7	关联硬件型号，匹配固件兼容性	需与设备实际型号一致，不可自定义
aspen.serial_number	设备SN码（厂商预设）	aspen.serial_number=SN202405001	绑定唯一设备身份，用于保修与溯源	出厂时写入，禁止手动修改
aspen.hw_version	硬件版本号（X.Y.Z格式）	aspen.hw_version=2.1.0	标识硬件迭代版本，适配驱动程序	与rbt_model联动，不可单独修改
aspen.fw_version	固件版本号（X.Y.Z格式）	aspen.fw_version=3.5.2	记录当前系统固件版本，用于升级判断	手动升级后需同步更新该字段
aspen.sensor_config	传感器类型+使能状态	aspen.sensor_config=lidar:on;ir:on	配置传感器启用/禁用（如激光雷达、红外）	禁用关键传感器（如lidar）会影响避障

二、网络连接配置（设备联网与云通信）

2.1 WiFi网络配置

配置字段	格式规范	配置示例	核心用途	注意事项
network.wifi.ssid	WiFi名称（原文，含特殊字符需转义）	network.wifi.ssid=Home_WiFi_5G	指定连接的WiFi热点名称	若SSID含空格，需用双引号包裹（如"Home WiFi"）
network.wifi.passphrase	密码原文（≤64位）	network.wifi.passphrase=Admin@2024	WiFi密码，支持WPA/WPA2加密	避免弱密码（如123456），需与路由器加密方式匹配
network.wifi.auto_connect	布尔值（on/off）	network.wifi.auto_connect=on	开机后自动连接已配置WiFi	多WiFi场景下，优先连接上次成功的热点
network.wifi.ip_mode	枚举值（dhcp/static）	network.wifi.ip_mode=dhcp	选择IP获取方式（自动/静态）	静态IP需额外配置ip_addr/gateway
network.wifi.ip_addr	静态IP地址（IPv4格式）	network.wifi.ip_addr=192.168.1.100	静态IP场景下指定设备IP	需与路由器网段一致（如192.168.1.x）
network.wifi.gateway	网关地址（IPv4格式）	network.wifi.gateway=192.168.1.1	静态IP场景下指定网关	通常为路由器管理IP

2.2 云通信配置

配置字段	格式规范	配置示例	核心用途	注意事项
cloud.server.url	云服务器地址（HTTP/HTTPS）	cloud.server.url=https://aspen-robot.cloud.com	指定机器人连接的云端服务器地址	需使用厂商提供的官方地址，不可自定义
cloud.server.port	端口号（1-65535）	cloud.server.port=443	云通信端口（HTTPS默认443，HTTP默认80）	端口错误会导致云连接失败
cloud.heartbeat.interval	心跳间隔（秒，≥10）	cloud.heartbeat.interval=30	机器人向云端发送心跳的频率	间隔过短会增加网络负载，过长会被判定离线
cloud.data.upload.mode	枚举值（real-time/batch）	cloud.data.upload.mode=batch	数据上传方式（实时/批量）	批量模式可减少流量消耗（如每5分钟上传一次清洁记录）

三、时间同步配置（确保定时任务准确性）

配置字段	格式规范	配置示例	核心用途	注意事项
aspen.timezone	标准时区标识符（Olson格式）	aspen.timezone=America/Denver	设定设备本地时区	需使用标准标识符（如中国为Asia/Shanghai），不可自定义
aspen.ntp.server	NTP服务器地址	aspen.ntp.server=ntp.aliyun.com	指定时间同步服务器	优先使用厂商推荐的NTP地址，确保时间准确性
aspen.ntp.sync.interval	同步间隔（分钟，≥10）	aspen.ntp.sync.interval=60	设备与NTP服务器同步时间的频率	间隔过短会增加网络请求，过长会导致时间偏差
aspen.time.format	时间显示格式（枚举）	aspen.time.format=yyyy-MM-dd HH:mm:ss	设定日志、任务中的时间显示格式	支持yyyy（年）、MM（月）、dd（日）、HH（24小时制）等占位符

四、功能控制配置（核心业务参数）

4.1 清洁功能配置（以扫地机器人为例）

配置字段	格式规范	配置示例	核心用途	注意事项
clean.mode.default	枚举值（auto/edge/spot）	clean.mode.default=auto	开机默认清洁模式（自动/沿边/定点）	需与机器人硬件支持的模式匹配
clean.suction.level	枚举值（low/mid/high）	clean.suction.level=mid	默认吸力等级（低/中/高）	高吸力会增加功耗，缩短续航
clean.water.level	枚举值（off/low/mid/high）	clean.water.level=mid	拖地模式下的出水量（关/低/中/高）	仅支持拖地功能的机型有效
clean.time.limit	清洁时长限制（分钟，0=无限制）	clean.time.limit=120	单次清洁最大时长（避免过度耗电）	0表示无限制，低电量时会自动停止
clean.return.charge.threshold	回充电量阈值（%，10-50）	clean.return.charge.threshold=20	电量低于该值时自动回充	阈值过低可能导致无法返回充电桩

4.2 移动与避障配置

配置字段	格式规范	配置示例	核心用途	注意事项
move.speed.default	移动速度（cm/s，1-50）	move.speed.default=30	默认清洁移动速度	速度过快可能影响避障精度
obstacle.avoid.level	枚举值（low/mid/high）	obstacle.avoid.level=high	避障灵敏度（低/中/高）	高灵敏度适合复杂家居环境，低灵敏度适合空旷场景
move.path.type	枚举值（planned/random）	move.path.type=planned	路径规划方式（规划式/随机式）	规划式需依赖lidar传感器，随机式适用于无lidar机型

五、安全与认证配置（设备与数据保护）

5.1 证书与加密配置

配置字段	格式规范	配置示例	核心用途	注意事项
security.ca.cert.path	根CA证书路径（绝对路径）	security.ca.cert.path=/etc/aspen/certs/root_ca.pem	指定云通信根证书存储路径	证书需为PEM格式，路径错误会导致认证失败
security.device.cert.path	设备证书路径（绝对路径）	security.device.cert.path=/etc/aspen/certs/device_cert.pem	指定设备身份证书路径	证书与设备SN绑定，不可混用
security.data.encrypt	布尔值（on/off）	security.data.encrypt=on	启用/禁用数据传输加密（如清洁记录、位置信息）	建议始终开启，防止数据泄露

5.2 权限控制配置

配置字段	格式规范	配置示例	核心用途	注意事项
auth.admin.password	管理员密码（≥8位，含字母+数字）	auth.admin.password=RobotAdmin@123	本地登录管理员密码（用于CLI或Web管理）	需定期修改，避免弱密码
auth.app.bind.max	最大绑定APP数量（1-10）	auth.app.bind.max=3	限制可绑定该机器人的APP数量	超过数量会导致新APP无法绑定
auth.operation.lock	布尔值（on/off）	auth.operation.lock=on	启用/禁用物理按键操作（防止误触）	开启后仅支持APP或云端控制

六、日志与运维配置（故障排查与系统更新）

6.1 日志配置

配置字段	格式规范	配置示例	核心用途	注意事项
log.level	枚举值（debug/info/warn/error）	log.level=info	设定日志输出级别（调试/信息/警告/错误）	debug级日志会占用大量存储，仅用于故障排查
log.storage.path	日志存储路径（绝对路径）	log.storage.path=/var/log/aspen/	指定日志文件存储位置	需确保路径有读写权限
log.storage.max.size	单日志文件最大大小（MB，10-100）	log.storage.max.size=50	限制单日志文件大小，避免存储溢出	超过大小会自动切割为新文件
log.upload.enable	布尔值（on/off）	log.upload.enable=on	启用/禁用日志自动上传至云端	故障时云端日志可帮助厂商定位问题

6.2 固件升级配置

配置字段	格式规范	配置示例	核心用途	注意事项
upgrade.server.url	升级服务器地址（HTTPS）	upgrade.server.url=https://aspen-upgrade.cloud.com	指定固件升级包下载地址	仅支持厂商官方地址，禁止第三方升级
upgrade.check.interval	检查间隔（小时，≥1）	upgrade.check.interval=24	自动检查固件更新的频率	建议每日检查一次，及时修复漏洞
upgrade.mode	枚举值（auto/manual）	upgrade.mode=manual	升级方式（自动/手动）	自动升级需确保设备在充电且联网状态

七、配置操作说明

1. 配置方式
   • 本地配置：通过机器人CLI命令（如aspen config set [字段名] [值]）或Web管理界面修改；
   • 远程配置：通过APP或云端管理平台下发配置（需权限认证）；
   • 文件配置：直接编辑系统配置文件（通常为/etc/aspen/config.ini），修改后需重启生效。
2. 格式规范
   • 所有配置均遵循“字段名=值”格式，键值之间不可有空格；
   • 字符串值含特殊字符（如空格、@）时，需用双引号包裹；
   • 枚举值需严格匹配选项（如clean.mode仅支持auto/edge/spot），不可自定义。
3. 注意事项
   • 修改核心配置（如serial_number、ca.cert.path）前需备份原配置，错误修改可能导致设备无法启动；
   • 网络、云通信相关配置修改后，需验证连接状态（如ping cloud.server.url）；
   • 权限敏感配置（如admin.password）需通过加密通道传输，避免明文泄露。