54 lines
1.6 KiB
C
54 lines
1.6 KiB
C
|
/*
|
|||
|
|
* gd32_adc_feedback.h - 被动接收 GD32 ADC 调试反馈（SPI TYPE 0xC4）
|
|||
|
|
*
|
|||
|
|
* 与 CAN 0xC1 同模型：GD32 1Hz 主动按铃推送，ESP32 takeEvent 侧解析入库。
|
|||
|
|
* 是否推送由 GD32 CONFIG_SPI_ADC_FEEDBACK_ENABLE 决定，经 HELLO/PING 身份块
|
|||
|
|
* （V2_FEAT_ADC_FEEDBACK）上报；ESP32 无本地开关，有帧即解析。
|
|||
|
|
*/
|
|||
|
|
#ifndef GD32_ADC_FEEDBACK_H
|
|||
|
|
#define GD32_ADC_FEEDBACK_H
|
|||
|
|
|
|||
|
|
#include <stdint.h>
|
|||
|
|
#include <stdbool.h>
|
|||
|
|
#include <stddef.h>
|
|||
|
|
|
|||
|
|
#ifdef __cplusplus
|
|||
|
|
extern "C" {
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
/** @brief 最近一次 GD32 ADC 调试快照（工程量已换算）。 */
|
|||
|
|
typedef struct {
|
|||
|
|
bool valid; ///< GD32 sample.valid
|
|||
|
|
float temperature_c; ///< ℃
|
|||
|
|
float vdda_v; ///< V（MCU 模拟供电，约 3.3）
|
|||
|
|
float vin_adc_v; ///< V（分压后 ADC 引脚 PA6）
|
|||
|
|
float vcc_v; ///< V（输入母线 VCC，由 vin 分压反推）
|
|||
|
|
uint16_t temp_raw;
|
|||
|
|
uint16_t vref_raw;
|
|||
|
|
uint32_t seq;
|
|||
|
|
uint32_t uptime_sec; ///< GD32 侧 uptime
|
|||
|
|
int64_t recv_ms; ///< ESP32 收到时 esp_timer ms
|
|||
|
|
} gd32_adc_feedback_t;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 处理一帧 0xC4 EVENT payload（由 can_fb 任务 takeEvent 分发）。
|
|||
|
|
* @return true 表示已接受并更新快照。
|
|||
|
|
*/
|
|||
|
|
bool onGd32AdcFeedbackEvent(const uint8_t *payload, size_t len);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 拷贝最新快照。
|
|||
|
|
* @param[out] out 输出缓冲
|
|||
|
|
* @return true 表示至少收到过一帧
|
|||
|
|
*/
|
|||
|
|
bool getLatestGd32AdcFeedback(gd32_adc_feedback_t *out);
|
|||
|
|
|
|||
|
|
/** @brief 距离上次收到的毫秒数；无数据返回 UINT32_MAX。 */
|
|||
|
|
uint32_t gd32AdcFeedbackAgeMs(void);
|
|||
|
|
|
|||
|
|
#ifdef __cplusplus
|
|||
|
|
}
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
#endif /* GD32_ADC_FEEDBACK_H */
|