50 lines
1.7 KiB
C
50 lines
1.7 KiB
C
/******************************************************************************
|
||
* @file app_arbiter.h
|
||
* @brief CBR2 喷淋仲裁（规格书第 13 章）：手动 > 计划队列 > 联动
|
||
* @author cyWu <1917507415@qq.com>
|
||
* @date 2026.09.09
|
||
* @version V1.0.0，首次发布
|
||
*
|
||
* @note 与加热垫独立 owner 状态机不同：本机 owner 单一事实源在
|
||
* app_spray 轮上下文（APP_SPRAY_OWNER_*），本模块负责
|
||
* 「手动作废联动」转调与「轮结束边沿收口」分发：
|
||
* 计划轮结束 → 单次自毁 + 出队下一条
|
||
* 队列非空 → 立刻 kick（不插队当前轮，只排队续跑）
|
||
* 否则 → 联动立刻补判（12.4：计划结束后接着循环）
|
||
******************************************************************************/
|
||
|
||
#ifndef __APP_ARBITER_H__
|
||
#define __APP_ARBITER_H__
|
||
|
||
#include <stdint.h>
|
||
|
||
/**
|
||
* @brief 初始化仲裁器
|
||
* @return 无
|
||
*/
|
||
void app_arbiter_init(void);
|
||
|
||
/**
|
||
* @brief 消费轮结束事件并收口（500ms 任务上下文，usr_timer_loop 调用）
|
||
* @note 位置须在 app_linkage_run / app_timer_run 之前：收口里补判的
|
||
* 联动 / 出队的计划当拍即生效
|
||
* @return 无
|
||
*/
|
||
void app_arbiter_poll(void);
|
||
|
||
/**
|
||
* @brief 手动介入：作废联动轮（PB1 停 / DP1=0 / DP7 抢权时调用）
|
||
* @return 无
|
||
*/
|
||
void app_arbiter_manual_intervene(void);
|
||
|
||
/**
|
||
* @brief 轮结束边沿收口（500ms 任务上下文，由 app_function_loop 消费事件调用）
|
||
* @param owner 结束轮来源（AppSprayOwner_t）
|
||
* @param slot 结束轮槽位（owner==PLAN 时有效）
|
||
* @return 无
|
||
*/
|
||
void app_arbiter_on_round_done(uint8_t owner, uint8_t slot);
|
||
|
||
#endif /* __APP_ARBITER_H__ */
|