跳到主要内容

Event 事件系统

Event 按事件 ID 注册和触发回调，支持从回调或中断中触发，以及把一个 Event 的事件绑定到另一个 Event。

功能​

  • 基于 事件 ID 注册多个回调；
  • 支持 线程/中断上下文触发；
  • 可通过 GetList() 实现 中断上下文安全事件触发；
  • 支持 事件桥接绑定，把一个 Event 的事件转发到另一个 Event；
  • 内部采用 红黑树 + 无锁链表 实现高效、并发安全存储。

快速使用​

注册事件回调​

int counter = 0;
LibXR::Event evt;
auto cb = LibXR::Event::Callback::Create(
    [](bool, int *cnt, uint32_t event) {
        (*cnt)++;
        ASSERT(event == 0x10);
    },
    &counter);

evt.Register(0x10, cb);

触发事件​

evt.Active(0x10);  // 普通线程上下文触发

中断上下文触发（需提前获取回调链表）​

// 在非回调中获取事件链表
auto list = evt.GetList(0x1234);
// 在回调中触发
evt.ActiveFromCallback(list, 0x1234, true);

事件绑定​

evt_dst.Bind(evt_src, 0xA, 0xB);  // 当 evt_src 的事件 0xA 触发时，会激活 evt_dst 的事件 0xB

类定义结构​

  • Event::Register(event, cb)：注册回调；
  • Event::Active(event)：非中断触发；
  • Event::ActiveFromCallback(list, event, in_isr)：回调安全触发；
  • Event::GetList(event)：获取并缓存事件链表；
  • Event::Bind(src, id_src, id_dst)：实现事件桥接；
  • Register()、GetList()（事件首次出现时）和 Bind() 会分配内存，在初始化阶段的线程上下文中调用；中断中只调用 ActiveFromCallback()；
  • 内部使用 RBTree<uint32_t> 管理事件映射，事件对应回调使用 LockFreeList 存储。

示例：测试事件绑定与触发​

int arg = 0;
auto cb = Event::Callback::Create([](bool, int* a, uint32_t e) {
  *a += 1;
}, &arg);

Event e1, e2;
e1.Register(0x1234, cb);
e2.Register(0x4321, cb);
e2.Bind(e1, 0x1234, 0x4321);
e1.Active(0x1234);  // arg += 2

应用场景​

  • 按键/传感器中断触发事件；
  • 多任务协作中的状态通知；
  • 与 Topic/Message 联动构建事件-消息系统。

更多信息请查阅 event.hpp 源码。