129 lines
3.6 KiB
C++
129 lines
3.6 KiB
C++
/**
|
|
* @file photo_interrupter.cc
|
|
* @brief 光电限位开关类实现文件
|
|
*
|
|
* 该类实现了光电限位开关的完整功能,包括初始化、中断处理、
|
|
* 回调函数管理等。支持起始位置和结束位置两个限位开关的检测。
|
|
*/
|
|
|
|
#include "photo_interrupter.h"
|
|
#include <esp_log.h>
|
|
|
|
#define TAG "PhotoInterrupter" ///< 日志标签,用于ESP-IDF日志系统
|
|
|
|
/**
|
|
* @brief 构造函数
|
|
*
|
|
* 初始化PhotoInterrupter对象,设置默认状态
|
|
* 目前构造函数为空,所有初始化操作在Init()方法中完成
|
|
*/
|
|
PhotoInterrupter::PhotoInterrupter()
|
|
{
|
|
|
|
}
|
|
|
|
/**
|
|
* @brief 析构函数
|
|
*
|
|
* 清理资源,释放分配的内存
|
|
* 目前析构函数为空,没有需要特殊清理的资源
|
|
*/
|
|
PhotoInterrupter::~PhotoInterrupter()
|
|
{
|
|
|
|
}
|
|
|
|
/**
|
|
* @brief 初始化限位开关
|
|
*
|
|
* 执行限位开关的初始化操作,包括：
|
|
* 1. 输出初始化日志
|
|
* 2. 设置默认的起始限位开关回调函数
|
|
* 3. 设置默认的结束限位开关回调函数
|
|
*
|
|
* 默认回调函数仅输出触发日志,用户可以通过OnStartTrigger()和OnEndTrigger()
|
|
* 方法覆盖这些默认回调函数
|
|
*/
|
|
void PhotoInterrupter::Init()
|
|
{
|
|
ESP_LOGI(TAG, "限位开关初始化");
|
|
|
|
// 设置默认回调函数 - 起始限位开关触发时输出日志
|
|
OnStartTrigger([]() {
|
|
ESP_LOGI(TAG, "起始限位开关触发 - 默认回调");
|
|
});
|
|
|
|
// 设置默认回调函数 - 结束限位开关触发时输出日志
|
|
OnEndTrigger([]() {
|
|
ESP_LOGI(TAG, "结束限位开关触发 - 默认回调");
|
|
});
|
|
}
|
|
|
|
/**
|
|
* @brief 处理限位开关中断
|
|
*
|
|
* 当限位开关被触发时调用的中断处理函数
|
|
* 目前仅输出中断触发日志,可以根据需要扩展更多处理逻辑
|
|
*/
|
|
void PhotoInterrupter::Interrupt()
|
|
{
|
|
ESP_LOGI(TAG, "限位开关中断触发");
|
|
}
|
|
|
|
/**
|
|
* @brief 设置起始限位开关触发回调函数
|
|
* @param callback 回调函数对象,当起始限位开关被触发时执行
|
|
*
|
|
* 允许用户自定义起始限位开关被触发时的处理逻辑。
|
|
* 该函数会保存传入的回调函数,并输出注册日志。
|
|
*/
|
|
void PhotoInterrupter::OnStartTrigger(std::function<void()> callback)
|
|
{
|
|
on_start_trigger_ = callback;
|
|
ESP_LOGI(TAG, "注册起始限位开关回调函数");
|
|
}
|
|
|
|
/**
|
|
* @brief 设置结束限位开关触发回调函数
|
|
* @param callback 回调函数对象,当结束限位开关被触发时执行
|
|
*
|
|
* 允许用户自定义结束限位开关被触发时的处理逻辑。
|
|
* 该函数会保存传入的回调函数,并输出注册日志。
|
|
*/
|
|
void PhotoInterrupter::OnEndTrigger(std::function<void()> callback)
|
|
{
|
|
on_end_trigger_ = callback;
|
|
ESP_LOGI(TAG, "注册结束限位开关回调函数");
|
|
}
|
|
|
|
/**
|
|
* @brief 触发起始限位开关回调
|
|
*
|
|
* 当检测到起始限位开关被触发时,执行注册的回调函数。
|
|
* 如果回调函数已设置(不为nullptr),则执行回调并输出触发日志。
|
|
*
|
|
* 该函数通常由IO扩展板在检测到起始限位开关中断时调用。
|
|
*/
|
|
void PhotoInterrupter::TriggerStartCallback()
|
|
{
|
|
if (on_start_trigger_) {
|
|
ESP_LOGI(TAG, "触发起始限位开关回调");
|
|
on_start_trigger_();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief 触发结束限位开关回调
|
|
*
|
|
* 当检测到结束限位开关被触发时,执行注册的回调函数。
|
|
* 如果回调函数已设置(不为nullptr),则执行回调并输出触发日志。
|
|
*
|
|
* 该函数通常由IO扩展板在检测到结束限位开关中断时调用。
|
|
*/
|
|
void PhotoInterrupter::TriggerEndCallback()
|
|
{
|
|
if (on_end_trigger_) {
|
|
ESP_LOGI(TAG, "触发结束限位开关回调");
|
|
on_end_trigger_();
|
|
}
|
|
} |