LibXR::Event Class Reference

事件管理系统，允许基于事件 ID 注册和触发回调函数。 Event management system that allows registration and triggering of callbacks based on event IDs. More...

#include <event.hpp>

Collaboration diagram for LibXR::Event:

Data Structures
struct	Block
	用于存储事件回调的数据结构。 Data structure for storing event callbacks. More...

Public Types
using	Callback = LibXR::Callback<uint32_t>
using	CallbackList = LockFreeList *
	回调链表指针类型，用于事件触发时从 ISR 中安全调用。 Pointer to the callback list, safe to use in ISR after acquired in non-interrupt context.

Public Member Functions
	Event ()
	构造函数，初始化用于存储事件的红黑树。 Constructs an Event object with an empty red-black tree for event storage.
void	Register (uint32_t event, const Callback &cb)
	为特定事件注册回调函数。 Registers a callback function for a specific event.
void	Active (uint32_t event)
	触发与特定事件关联的所有回调函数（非中断上下文）。 Triggers all callbacks associated with a specific event (non-interrupt context).
void	ActiveFromCallback (CallbackList list, uint32_t event)
	从回调函数中触发与特定事件关联的所有回调函数。 Triggers all callbacks associated with a specific event (interrupt context).
CallbackList	GetList (uint32_t event)
	获取指定事件的回调链表指针（必须在非中断上下文中调用）。 Returns the callback list pointer for the given event (must be called outside ISR).
void	Bind (Event &sources, uint32_t source_event, uint32_t target_event)
	将源事件绑定到当前事件实例中的目标事件。 Binds an event from a source Event instance to a target event in the current instance.

Private Attributes
RBTree< uint32_t >	rbt_

Detailed Description

事件管理系统，允许基于事件 ID 注册和触发回调函数。 Event management system that allows registration and triggering of callbacks based on event IDs.

Definition at line 17 of file event.hpp.

Member Typedef Documentation

Callback

using LibXR::Event::Callback = LibXR::Callback<uint32_t>

Definition at line 20 of file event.hpp.

CallbackList

using LibXR::Event::CallbackList = LockFreeList *

回调链表指针类型，用于事件触发时从 ISR 中安全调用。 Pointer to the callback list, safe to use in ISR after acquired in non-interrupt context.

Definition at line 27 of file event.hpp.

Constructor & Destructor Documentation

Event()

Event::Event

(

)

构造函数，初始化用于存储事件的红黑树。 Constructs an Event object with an empty red-black tree for event storage.

Definition at line 7 of file event.cpp.

    : rbt_([](const uint32_t &a, const uint32_t &b)
           { return static_cast<int>(a) - static_cast<int>(b); })
{
}

Member Function Documentation

Active()

void Event::Active

(

uint32_t

event

)

触发与特定事件关联的所有回调函数（非中断上下文）。 Triggers all callbacks associated with a specific event (non-interrupt context).

Parameters

event

要激活的事件 ID。 The event ID to activate.

Definition at line 30 of file event.cpp.

{
  auto list = rbt_.Search<LockFreeList>(event);
  if (!list)
  {
    return;
  }
 
  auto foreach_fun = [=](Block &block)
  {
    block.cb.Run(false, event);
    return ErrorCode::OK;
  };
 
  list->data_.Foreach<LibXR::Event::Block>(foreach_fun);
}

ActiveFromCallback()

void Event::ActiveFromCallback	(	CallbackList	list,
		uint32_t	event )

从回调函数中触发与特定事件关联的所有回调函数。 Triggers all callbacks associated with a specific event (interrupt context).

Parameters

list	在非回调函数中获取的事件回调链表指针。 The event callback list pointer obtained from the non-callback function.
event	要激活的事件 ID。 The event ID to activate.

Definition at line 47 of file event.cpp.

{
  if (!list)
  {
    return;
  }
 
  auto foreach_fun = [=](Block &block)
  {
    block.cb.Run(true, event);
    return ErrorCode::OK;
  };
 
  list->Foreach<Block>(foreach_fun);
}

Bind()

void Event::Bind	(	Event &	sources,
		uint32_t	source_event,
		uint32_t	target_event )

将源事件绑定到当前事件实例中的目标事件。 Binds an event from a source Event instance to a target event in the current instance.

Parameters

sources	包含原始事件的源 Event 实例。 The source Event instance.
source_event	源事件实例中的事件 ID。 The source event ID.
target_event	当前实例中的目标事件 ID。 The target event ID in this instance.

Definition at line 75 of file event.cpp.

{
  struct BindBlock
  {
    Event *target;
    uint32_t event;
  };
 
  auto block = new BindBlock{this, target_event};
 
  auto bind_fun = [](bool in_isr, BindBlock *block, uint32_t event)
  {
    UNUSED(event);
    UNUSED(in_isr);
    block->target->ActiveFromCallback(block->target->GetList(block->event), block->event);
  };
 
  auto cb = Callback::Create(bind_fun, block);
 
  sources.Register(source_event, cb);
}

GetList()

Event::CallbackList Event::GetList

(

uint32_t

event

)

获取指定事件的回调链表指针（必须在非中断上下文中调用）。 Returns the callback list pointer for the given event (must be called outside ISR).

Parameters

event

要查询的事件 ID。 The event ID to search.

Returns

回调链表指针，如果未注册则主动创建。 The callback list pointer, if not registered, it is actively created.

Definition at line 63 of file event.cpp.

{
  auto node = rbt_.Search<LockFreeList>(event);
  if (!node)
  {
    auto list = new RBTree<uint32_t>::Node<LockFreeList>;
    rbt_.Insert(*list, event);
    node = list;
  }
  return &node->data_;
}

Register()

void Event::Register	(	uint32_t	event,
		const Callback &	cb )

为特定事件注册回调函数。 Registers a callback function for a specific event.

Parameters

event	要注册回调的事件 ID。 The event ID to register the callback for.
cb	事件触发时执行的回调函数。 The callback function to be executed when the event occurs.

Definition at line 13 of file event.cpp.

{
  auto list = rbt_.Search<LockFreeList>(event);
 
  if (!list)
  {
    list = new RBTree<uint32_t>::Node<LockFreeList>;
    rbt_.Insert(*list, event);
  }
 
  LockFreeList::Node<Block> *node = new LockFreeList::Node<Block>;
 
  node->data_.event = event;
  node->data_.cb = cb;
  list->data_.Add(*node);
}

Field Documentation

rbt_

RBTree<uint32_t> LibXR::Event::rbt_

private

用于管理已注册事件的红黑树。 Red-black tree for managing registered events.

Definition at line 96 of file event.hpp.

---

The documentation for this class was generated from the following files:

• src/middleware/event.hpp
• src/middleware/event.cpp