81 lines
2.1 KiB
C
81 lines
2.1 KiB
C
/******************************************************************************
|
||
* @file app_runrec.h
|
||
* @brief CBR0 31 天运行记录（第 13.1 节，DP20 RO，124B）：实际吸合计秒
|
||
* @author cyWu <1917507415@qq.com>
|
||
* @date 2026.09.04
|
||
* @version V1.0.0，P0 = 骨架（BOARD_RUNREC_ENABLE=0；P2 填充）
|
||
*
|
||
* @note 什么叫在运行：过零后继电器**实际已吸合**（app_relay_get_actual()==1）。
|
||
* 日期轴：未对时只往 slot[0] 加不旋转；对时后按本地日历左移。
|
||
* 落盘：每累计 600s 写一次 VM；跨天立刻写。
|
||
******************************************************************************/
|
||
|
||
#ifndef __APP_RUNREC_H__
|
||
#define __APP_RUNREC_H__
|
||
|
||
#include <stdint.h>
|
||
#include "board_pin.h"
|
||
|
||
#define APP_RUNREC_PACK_LEN (BOARD_RUN_RECORD_DAYS * 4u) /**< 124B */
|
||
|
||
/**
|
||
* @brief 初始化（未对时：只往 slot0 加，不旋转）
|
||
* @return 无
|
||
*/
|
||
void app_runrec_init(void);
|
||
|
||
/**
|
||
* @brief 20ms 节拍：继电器实际吸合则累计秒，满 10 分钟打脏（不写 flash）
|
||
* @param dt 距上次调用的毫秒数
|
||
* @return 无
|
||
*/
|
||
void app_runrec_tick(uint16_t dt);
|
||
|
||
/**
|
||
* @brief 500ms 任务上下文：收下 pending 秒并灌 DP20；对时后跨天左移旋转
|
||
* @return 无
|
||
*/
|
||
void app_runrec_rotate_if_needed(void);
|
||
|
||
/**
|
||
* @brief 读某天秒数（0=今天）
|
||
* @param day 0~30
|
||
* @return 秒
|
||
*/
|
||
uint32_t app_runrec_get(uint8_t day);
|
||
|
||
/**
|
||
* @brief 打包 124B（每格 uint32 大端），灌 gDevData.run_record
|
||
* @param out 输出缓冲（≥124B）
|
||
* @return 无
|
||
*/
|
||
void app_runrec_pack(uint8_t *out);
|
||
|
||
/**
|
||
* @brief 从 VM 解包 124B（uint32 大端）
|
||
* @param in 输入缓冲
|
||
* @return 无
|
||
*/
|
||
void app_runrec_unpack(const uint8_t *in);
|
||
|
||
/**
|
||
* @brief slot[0] 对应本地日期（yyyymmdd 打包）
|
||
* @return 日期
|
||
*/
|
||
uint32_t app_runrec_get_slot0_date(void);
|
||
|
||
/**
|
||
* @brief 设置 slot[0] 日期（对时/旋转后写回）
|
||
* @param ymd yyyymmdd
|
||
* @return 无
|
||
*/
|
||
void app_runrec_set_slot0_date(uint32_t ymd);
|
||
|
||
/**
|
||
* @brief 清零 31 天记录与日期（出厂重置）
|
||
* @return 无
|
||
*/
|
||
void app_runrec_reset(void);
|
||
|
||
#endif /* __APP_RUNREC_H__ */
|