System模块的架构和功能
classDiagram
class System {
-scripts_path: path
-config: Conf
+update_firmware(FirmwareUpdateRequest)
+upload_logs(UploadLogsRequest)
+is_reset_allowed(ResetType): bool
+reset(ResetType, bool)
+set_system_time(string): bool
+get_boot_reason(): BootReason
}
class SystemImpl {
-scripts_path: path
-log_upload_running: bool
-firmware_download_running: bool
-firmware_installation_running: bool
-standard_firmware_update_running: bool
-update_firmware_thread: thread
+init()
+ready()
+handle_standard_firmware_update(FirmwareUpdateRequest)
+handle_signed_firmware_update(FirmwareUpdateRequest)
+download_signed_firmware(FirmwareUpdateRequest)
+upload_logs(UploadLogsRequest)
}
class FirmwareUpdateRequest {
+location: string
+request_id: int
+retries: int
+retry_interval_s: int
+retrieve_timestamp: string
+install_timestamp: string
+signing_certificate: string
+signature: string
}
class FirmwareUpdateStatus {
+firmware_update_status: FirmwareUpdateStatusEnum
+request_id: int
}
class UploadLogsRequest {
+location: string
+retries: int
+retry_interval_s: int
+oldest_timestamp: string
+latest_timestamp: string
+type: string
+request_id: int
}
class LogStatus {
+log_status: LogStatusEnum
+request_id: int
}
class ResetType {
<<enumeration>>
Soft
Hard
NotSpecified
}
class BootReason {
<<enumeration>>
ApplicationReset
FirmwareUpdate
LocalReset
PowerUp
RemoteReset
ScheduledReset
Triggered
Unknown
Watchdog
}
class FirmwareUpdateStatusEnum {
<<enumeration>>
Downloaded
DownloadFailed
Downloading
DownloadScheduled
DownloadPaused
Idle
InstallationFailed
Installing
Installed
InstallRebooting
InstallScheduled
InstallVerificationFailed
InvalidSignature
SignatureVerified
}
System --> SystemImpl
SystemImpl --> FirmwareUpdateRequest
SystemImpl --> FirmwareUpdateStatus
SystemImpl --> UploadLogsRequest
SystemImpl --> LogStatus
System --> ResetType
System --> BootReason
FirmwareUpdateStatus --> FirmwareUpdateStatusEnum
System模块功能分析
System模块是Everest Core项目中负责系统级操作的核心模块，主要提供以下功能：
固件更新管理
sequenceDiagram
participant Client
participant System
participant SystemImpl
participant Scripts
Client->>System: update_firmware(request)
System->>SystemImpl: handle_firmware_update(request)
alt Signed Firmware
SystemImpl->>Scripts: signed_firmware_downloader.sh
Scripts-->>SystemImpl: Download Status
SystemImpl->>Scripts: signed_firmware_installer.sh
Scripts-->>SystemImpl: Install Status
else Standard Firmware
SystemImpl->>Scripts: firmware_updater.sh
Scripts-->>SystemImpl: Update Status
end
SystemImpl->>System: FirmwareUpdateStatus
System->>Client: UpdateFirmwareResponse
固件更新功能支持：
- 标准固件更新
- 签名固件更新（带证书验证）
- 支持重试机制
- 支持定时下载和安装
- 状态监控和报告
日志管理
sequenceDiagram
participant Client
participant System
participant SystemImpl
participant Scripts
Client->>System: upload_logs(request)
System->>SystemImpl: handle_upload_logs(request)
SystemImpl->>Scripts: diagnostics_uploader.sh
Scripts-->>SystemImpl: Upload Status
SystemImpl->>System: LogStatus
System->>Client: UploadLogsResponse
日志管理功能包括：
- 日志上传
- 时间范围筛选
- 支持多种日志类型
- 上传状态监控
系统重置
stateDiagram-v2
[*] --> CheckAllowed
CheckAllowed --> WaitForTransactions: is_reset_allowed()
WaitForTransactions --> ExecuteReset: All transactions finished
ExecuteReset --> Soft: ResetType.Soft
ExecuteReset --> Hard: ResetType.Hard
Soft --> [*]: Application restart
Hard --> [*]: System reboot
系统重置功能：
- 软重置（应用重启）
- 硬重置（系统重启）
- 支持延迟执行
- 安全检查机制
系统时间管理
sequenceDiagram
participant Client
participant System
participant SystemTime
Client->>System: set_system_time(timestamp)
System->>SystemTime: Update system time
SystemTime-->>System: Update result
System->>Client: Success/Failure
时间管理功能：
- 系统时间设置
- RFC3339格式支持
- 时间同步验证
启动原因追踪
stateDiagram-v2
[*] --> BootReasonCheck
BootReasonCheck --> ApplicationReset: Software restart
BootReasonCheck --> FirmwareUpdate: After update
BootReasonCheck --> PowerUp: Cold boot
BootReasonCheck --> RemoteReset: Remote triggered
BootReasonCheck --> Watchdog: System recovery
启动原因追踪功能：
- 记录系统启动原因
- 支持多种启动场景识别
- 用于系统诊断和监控
关键代码分析
固件更新处理
types::system::UpdateFirmwareResponse
systemImpl::handle_signed_fimware_update(const types::system::FirmwareUpdateRequest& firmware_update_request) {
// 验证证书和签名
if (!firmware_update_request.signing_certificate.has_value() ||
!firmware_update_request.signature.has_value()) {
return types::system::UpdateFirmwareResponse::Rejected;
}
// 处理定时下载
if (firmware_update_request.retrieve_timestamp.has_value()) {
schedule_download(firmware_update_request);
} else {
start_immediate_download(firmware_update_request);
}
// 返回更新状态
if (this->firmware_download_running) {
return UpdateFirmwareResponse::AcceptedCanceled;
} else if (this->firmware_installation_running) {
return UpdateFirmwareResponse::Rejected;
} else {
return UpdateFirmwareResponse::Accepted;
}
}配置管理
config:
DefaultRetries:
description: 文件上传/下载失败重试次数
type: number
default: 1
DefaultRetryInterval:
description: 重试间隔时间（秒）
type: number
default: 1
ResetDelay:
description: 重置延迟时间（秒）
type: integer
minimum: 0
default: 0状态管理
struct SystemState {
bool log_upload_running;
bool firmware_download_running;
bool firmware_installation_running;
bool standard_firmware_update_running;
std::atomic<bool> interrupt_firmware_download;
std::mutex firmware_update_mutex;
std::condition_variable firmware_update_cv;
};模块特点
可扩展性
- 模块化设计
- 清晰的接口定义
- 支持自定义脚本扩展
可靠性
- 完善的错误处理
- 重试机制
- 状态监控和报告
安全性
- 签名固件验证
- 证书管理
- 安全的系统操作
灵活性
- 可配置的参数
- 支持定时操作
- 多种操作模式
使用场景
远程维护
系统管理
- 时间同步
- 系统重置
- 状态监控
故障恢复
- 系统重置
- 日志分析
- 启动追踪
System模块作为EVerest-core的系统管理核心，提供了完整的系统级操作接口，确保了充电系统的可维护性、可靠性和安全性。