USB 组合管理器：class 列表、字符串、BOS、配置切换 USB composition manager: class list, strings, BOS, and configuration switching. More...

#include <device_composition.hpp>

Collaboration diagram for LibXR::USB::DeviceComposition:

Data Structures
struct	ConfigItems
	单个 configuration 的扁平 item 表 Flattened item table for one configuration. More...

Public Member Functions
	DeviceComposition (EndpointPool &endpoint_pool, const std::initializer_list< const DescriptorStrings::LanguagePack * > &lang_list, const std::initializer_list< const std::initializer_list< ConfigDescriptorItem * > > &configs, ConstRawData uid={nullptr, 0}, uint8_t bmAttributes=CFG_BUS_POWERED, uint8_t bMaxPower=50)
	构造 USB 组合管理器 Construct the USB composition manager.

	DeviceComposition (const DeviceComposition &)=delete

DeviceComposition &	operator= (const DeviceComposition &)=delete

	DeviceComposition (DeviceComposition &&)=delete

DeviceComposition &	operator= (DeviceComposition &&)=delete

void	Init (bool in_isr)
	初始化当前 configuration 的运行态资源 Initialize runtime resources for the active configuration.

void	Deinit (bool in_isr)
	释放当前 configuration 的运行态资源 Release runtime resources for the active configuration.

ErrorCode	SwitchConfig (size_t index, bool in_isr)
	切换到指定 configuration value Switch to the given configuration value.

ErrorCode	BuildConfigDescriptor ()
	生成当前 configuration 描述符缓存 Build the current configuration descriptor cache.

RawData	GetConfigDescriptor () const
	获取当前 configuration 描述符缓存 Get the current configuration descriptor cache.

ConstRawData	GetBosDescriptor ()
	获取当前 BOS 描述符缓存 / Get the current BOS descriptor cache

ErrorCode	ProcessBosVendorRequest (bool in_isr, const SetupPacket *setup, BosVendorResult &result)
	分发 BOS vendor request / Dispatch BOS vendor requests

ErrorCode	GetStringDescriptor (uint8_t string_index, uint16_t lang, ConstRawData &data)
	获取字符串描述符（含 interface string） Get a string descriptor, including runtime-generated interface strings.

bool	IsComposite () const
	是否为复合设备 / Whether this is a composite device

ErrorCode	TryOverrideDeviceDescriptor (DeviceDescriptor &descriptor)
	用当前配置覆盖 device descriptor 的类字段 Try to override device-descriptor class fields from the current configuration.

size_t	GetConfigNum () const
	配置数量 / Number of configurations

size_t	GetCurrentConfig () const
	当前 configuration value / Current configuration value

uint16_t	GetDeviceStatus () const
	设备 GET_STATUS 返回值 / Device-level GET_STATUS value

DeviceClass *	FindClassByInterfaceNumber (size_t index) const
	按接口号查找所属 class Find the owning class by interface number.

DeviceClass *	FindClassByEndpointAddress (uint8_t addr) const
	按端点地址查找所属 class Find the owning class by endpoint address.

Private Member Functions
const ConfigItems &	CurrentConfigItems () const
	获取当前激活 configuration 的扁平 item 表 Get the flattened item table of the active configuration.

void	BindEndpoints (bool in_isr)
	绑定当前配置的全部端点 / Bind all endpoints for the active configuration

void	UnbindEndpoints (bool in_isr)
	解绑当前配置的全部端点 / Unbind all endpoints for the active configuration

void	RebuildBosCache ()
	按当前配置重建 BOS capability 缓存 Rebuild the BOS capability cache from the active configuration.

void	RegisterInterfaceStrings ()
	为所有 class 分配并登记 interface string 索引 Allocate and register interface-string indices for all classes.

ErrorCode	GenerateInterfaceString (uint8_t string_index, ConstRawData &data)
	运行时生成 interface string 描述符 Generate one interface-string descriptor at runtime.

Private Attributes
bool	configured_ = false
	是否已进入非 0 配置态 / Whether a non-zero config is active

bool	ep_assigned_ = false
	端点是否已绑定 / Whether endpoints are assigned

EndpointPool &	endpoint_pool_
	端点池引用 / Endpoint pool reference

uint8_t	current_cfg_ = 0
	当前配置索引 / Current configuration index

uint8_t	i_configuration_ = 0
	配置字符串索引 / Configuration string index

uint8_t	bm_attributes_ = CFG_BUS_POWERED
	配置属性 / bmAttributes

const bool	composite_ = false
	是否为复合设备 / Whether composite device

const size_t	config_num_ = 0
	配置数量 / Configuration count

ConfigItems *	items_ = nullptr
	配置项集合 / Configuration item set

DeviceClass **	classes_ = nullptr
	唯一 class 表 / Unique class table

size_t	class_count_ = 0
	唯一 class 数量 / Unique class count

DescriptorStrings	strings_
	字符串描述符管理 / String descriptor manager

const char **	interface_strings_
	接口字符串源表 / Interface string source table

size_t	interface_string_count_
	接口字符串总数量 / Total interface string count

RawData	interface_string_buffer_
	临时字符串描述符缓冲区 / Temp interface string descriptor buffer

BosManager	bos_
	BOS 聚合管理 / BOS aggregation manager.

ConfigDescriptor	config_desc_
	配置描述符构造器 / Configuration descriptor builder

Detailed Description

USB 组合管理器：class 列表、字符串、BOS、配置切换 USB composition manager: class list, strings, BOS, and configuration switching.

Definition at line 20 of file device_composition.hpp.

Constructor & Destructor Documentation

◆ DeviceComposition()

DeviceComposition::DeviceComposition	(	EndpointPool &	endpoint_pool,
		const std::initializer_list< const DescriptorStrings::LanguagePack * > &	lang_list,
		const std::initializer_list< const std::initializer_list< ConfigDescriptorItem * > > &	configs,
		ConstRawData	uid = {nullptr, 0},
		uint8_t	bmAttributes = CFG_BUS_POWERED,
		uint8_t	bMaxPower = 50 )

构造 USB 组合管理器 Construct the USB composition manager.

负责把 class/config/string/BOS 相关静态信息整理成 DeviceCore 可直接使用的形态。 This flattens class/config/string/BOS metadata into the shape consumed by DeviceCore.

Definition at line 345 of file device_composition.cpp.

    : endpoint_pool_(endpoint_pool),
      bm_attributes_(bmAttributes),
      composite_(is_composite_device(configs)),
      config_num_(configs.size()),
      items_(new ConfigItems[config_num_]),
      classes_(new DeviceClass*[calc_total_item_num(configs)]),
      strings_(lang_list, reinterpret_cast<const uint8_t*>(uid.addr_), uid.size_),
      bos_(calc_bos_descriptor_size_max(configs), calc_bos_capability_num_max(configs)),
      config_desc_(ConfigDescriptor::CalcMaxConfigSize(configs), bmAttributes, bMaxPower)
{
  ASSERT(config_num_ > 0);
 
  // 将所有配置项整理成：
  // 1) 每个 configuration 自己的 item 表
  // 2) 一份用于字符串注册的唯一 class 表
  // Flatten every configuration item into:
  // 1) per-config item tables for descriptor building / binding
  // 2) one unique class table for string registration
  size_t config_index = 0;
  for (const auto& cfg_group : configs)
  {
    items_[config_index].item_num = cfg_group.size();
    items_[config_index].items = new ConfigDescriptorItem*[cfg_group.size()];
 
    size_t item_index = 0;
    for (auto* item : cfg_group)
    {
      items_[config_index].items[item_index++] = item;
      auto* device_class = static_cast<DeviceClass*>(item);
      if (device_class != nullptr &&
          !contains_class(classes_, class_count_, device_class))
      {
        classes_[class_count_++] = device_class;
      }
    }
 
    ++config_index;
  }
 
  // 初始化阶段一次性算出接口字符串容量和最大描述符空间。
  // Pre-compute interface-string storage once during initialization.
  const auto interface_string_layout =
      calc_interface_string_layout(classes_, class_count_);
  interface_string_count_ = interface_string_layout.count;
  if (interface_string_count_ > 0)
  {
    interface_strings_ = new const char*[interface_string_count_];
    interface_string_buffer_.addr_ = new uint8_t[interface_string_layout.max_len + 2];
    interface_string_buffer_.size_ = interface_string_layout.max_len + 2;
  }
 
  RegisterInterfaceStrings();
}

Member Function Documentation

◆ BindEndpoints()

void DeviceComposition::BindEndpoints ( bool in_isr )

private

绑定当前配置的全部端点 / Bind all endpoints for the active configuration

Definition at line 599 of file device_composition.cpp.

{
  if (ep_assigned_)
  {
    return;
  }
  ep_assigned_ = true;
 
  const auto& config = CurrentConfigItems();
 
  // start_itf tracks the configuration-global interface number assigned to each class.
  // start_itf 记录 configuration 级别的全局接口号分配游标。
  size_t start_itf = 0;
  for (size_t i = 0; i < config.item_num; ++i)
  {
    auto* item = config.items[i];
    if (item == nullptr)
    {
      continue;
    }
 
    item->BindEndpoints(endpoint_pool_, static_cast<uint8_t>(start_itf), in_isr);
    start_itf += item->GetInterfaceCount();
  }
}

◆ BuildConfigDescriptor()

LibXR::ErrorCode DeviceComposition::BuildConfigDescriptor ( )

生成当前 configuration 描述符缓存 Build the current configuration descriptor cache.

Definition at line 454 of file device_composition.cpp.

{
  // ConfigDescriptor 只构建当前激活的 configuration；
  // current_cfg_ 同时决定 item 表和对外可见的 bConfigurationValue。
  // ConfigDescriptor builds the active configuration only;
  // current_cfg_ supplies both the item table and the externally visible
  // bConfigurationValue.
  const auto& config = CurrentConfigItems();
  return config_desc_.BuildConfigDescriptor(config.items, config.item_num,
                                            static_cast<uint8_t>(current_cfg_ + 1),
                                            i_configuration_);
}

◆ CurrentConfigItems()

const DeviceComposition::ConfigItems & DeviceComposition::CurrentConfigItems ( ) const

nodiscardprivate

获取当前激活 configuration 的扁平 item 表 Get the flattened item table of the active configuration.

Definition at line 405 of file device_composition.cpp.

{
  ASSERT(config_num_ > 0);
  ASSERT(current_cfg_ < config_num_);
  return items_[current_cfg_];
}

◆ Deinit()

void DeviceComposition::Deinit ( bool in_isr )

释放当前 configuration 的运行态资源 Release runtime resources for the active configuration.

Definition at line 421 of file device_composition.cpp.

{
  UnbindEndpoints(in_isr);
  configured_ = false;
  current_cfg_ = 0;
}

◆ FindClassByEndpointAddress()

DeviceClass * DeviceComposition::FindClassByEndpointAddress ( uint8_t addr ) const

nodiscard

按端点地址查找所属 class Find the owning class by endpoint address.

Definition at line 573 of file device_composition.cpp.

{
  if (!configured_)
  {
    return nullptr;
  }
 
  const auto& config = CurrentConfigItems();
 
  for (size_t i = 0; i < config.item_num; ++i)
  {
    auto* item = config.items[i];
    if (item == nullptr)
    {
      continue;
    }
 
    if (item->OwnsEndpoint(addr))
    {
      return static_cast<DeviceClass*>(item);
    }
  }
 
  return nullptr;
}

◆ FindClassByInterfaceNumber()

DeviceClass * DeviceComposition::FindClassByInterfaceNumber ( size_t index ) const

nodiscard

按接口号查找所属 class Find the owning class by interface number.

Definition at line 541 of file device_composition.cpp.

{
  if (!configured_)
  {
    return nullptr;
  }
 
  const auto& config = CurrentConfigItems();
 
  // 每个 item 都声明自己占用的接口数量；
  // 沿扁平表前进，直到目标接口落入某个 item 的区间。
  // Each item reports how many interfaces it occupies; walk the flattened list
  // until the requested interface falls into one item's local range.
  int interface_index = -1;
  for (size_t i = 0; i < config.item_num; ++i)
  {
    auto* item = config.items[i];
    if (item == nullptr)
    {
      continue;
    }
 
    interface_index += static_cast<int>(item->GetInterfaceCount());
    if (interface_index >= static_cast<int>(index))
    {
      return static_cast<DeviceClass*>(item);
    }
  }
 
  return nullptr;
}

◆ GenerateInterfaceString()

LibXR::ErrorCode DeviceComposition::GenerateInterfaceString	(	uint8_t	string_index,
		ConstRawData &	data )

private

运行时生成 interface string 描述符 Generate one interface-string descriptor at runtime.

Definition at line 676 of file device_composition.cpp.

{
  // 接口字符串位于内建 manufacturer/product/serial 之后的索引区间。
  // Interface strings live after the built-in manufacturer/product/serial range.
  const size_t base_index =
      static_cast<uint8_t>(DescriptorStrings::Index::SERIAL_NUMBER_STRING);
  if (string_index <= base_index)
  {
    return LibXR::ErrorCode::NOT_FOUND;
  }
 
  const size_t extra_index = static_cast<size_t>(string_index - base_index - 1u);
  if (extra_index >= interface_string_count_ || interface_string_buffer_.addr_ == nullptr)
  {
    return LibXR::ErrorCode::NOT_FOUND;
  }
 
  uint8_t* buffer = reinterpret_cast<uint8_t*>(interface_string_buffer_.addr_);
  const char* str = interface_strings_[extra_index];
  const size_t utf16_len = calc_utf16le_len_runtime(str);
  ASSERT(utf16_len + 2 <= 255);
 
  // USB 字符串描述符格式：[bLength][bDescriptorType=0x03][UTF-16LE payload...]
  // USB string descriptor layout: [bLength][bDescriptorType=0x03][UTF-16LE payload...]
  buffer[1] = 0x03;
  buffer[0] = static_cast<uint8_t>(utf16_len + 2);
  to_utf16le(str, buffer + 2);
  data = ConstRawData(interface_string_buffer_.addr_, buffer[0]);
  return LibXR::ErrorCode::OK;
}

◆ GetBosDescriptor()

ConstRawData DeviceComposition::GetBosDescriptor ( )

nodiscard

获取当前 BOS 描述符缓存 / Get the current BOS descriptor cache

Definition at line 469 of file device_composition.cpp.

469{ return bos_.GetBosDescriptor(); }

LibXR::USB::BosManager::GetBosDescriptor

ConstRawData GetBosDescriptor()

构建 BOS 描述符（BOS 头 + 能力块） Build BOS descriptor (header + blocks).

Definition bos.hpp:158

◆ GetConfigDescriptor()

RawData DeviceComposition::GetConfigDescriptor ( ) const

nodiscard

获取当前 configuration 描述符缓存 Get the current configuration descriptor cache.

Definition at line 467 of file device_composition.cpp.

467{ return config_desc_.GetData(); }

LibXR::USB::ConfigDescriptor::GetData

RawData GetData() const

获取配置描述符数据 / Get configuration descriptor data

Definition desc_cfg.cpp:111

◆ GetConfigNum()

size_t DeviceComposition::GetConfigNum ( ) const

nodiscard

配置数量 / Number of configurations

Definition at line 528 of file device_composition.cpp.

528{ return config_num_; }

◆ GetCurrentConfig()

size_t DeviceComposition::GetCurrentConfig ( ) const

nodiscard

当前 configuration value / Current configuration value

Definition at line 530 of file device_composition.cpp.

{
  return configured_ ? static_cast<size_t>(current_cfg_ + 1u) : 0u;
}

◆ GetDeviceStatus()

uint16_t DeviceComposition::GetDeviceStatus ( ) const

nodiscard

设备 GET_STATUS 返回值 / Device-level GET_STATUS value

Definition at line 535 of file device_composition.cpp.

{
  return ((bm_attributes_ & CFG_SELF_POWERED) ? 0x01 : 0x00) |
         ((bm_attributes_ & CFG_REMOTE_WAKEUP) ? 0x02 : 0x00);
}

◆ GetStringDescriptor()

LibXR::ErrorCode DeviceComposition::GetStringDescriptor	(	uint8_t	string_index,
		uint16_t	lang,
		ConstRawData &	data )

获取字符串描述符（含 interface string） Get a string descriptor, including runtime-generated interface strings.

Definition at line 478 of file device_composition.cpp.

{
  if (string_index == 0)
  {
    data = ConstRawData(strings_.GetLangIDData());
    return LibXR::ErrorCode::OK;
  }
 
  if (string_index > static_cast<uint8_t>(DescriptorStrings::Index::SERIAL_NUMBER_STRING))
  {
    // 接口字符串与内建字符串集合共用同一套语言号校验。
    // Interface strings share the same language gate as the built-in string set.
    if (!strings_.HasLanguage(lang))
    {
      return LibXR::ErrorCode::NOT_FOUND;
    }
    return GenerateInterfaceString(string_index, data);
  }
 
  auto ec =
      strings_.GenerateString(static_cast<DescriptorStrings::Index>(string_index), lang);
  if (ec != LibXR::ErrorCode::OK)
  {
    return ec;
  }
 
  data = ConstRawData(strings_.GetData());
  return LibXR::ErrorCode::OK;
}

◆ Init()

void DeviceComposition::Init ( bool in_isr )

初始化当前 configuration 的运行态资源 Initialize runtime resources for the active configuration.

Definition at line 412 of file device_composition.cpp.

{
  // Init 先绑定端点，再按当前激活配置重建 BOS 视图。
  // Init binds endpoints first, then rebuilds the BOS view for the active configuration.
  configured_ = false;
  BindEndpoints(in_isr);
  RebuildBosCache();
}

◆ IsComposite()

bool DeviceComposition::IsComposite ( ) const

nodiscard

是否为复合设备 / Whether this is a composite device

Definition at line 509 of file device_composition.cpp.

509{ return composite_; }

◆ ProcessBosVendorRequest()

LibXR::ErrorCode DeviceComposition::ProcessBosVendorRequest	(	bool	in_isr,
		const SetupPacket *	setup,
		BosVendorResult &	result )

分发 BOS vendor request / Dispatch BOS vendor requests

Definition at line 471 of file device_composition.cpp.

{
  return bos_.ProcessVendorRequest(in_isr, setup, result);
}

◆ RebuildBosCache()

void DeviceComposition::RebuildBosCache ( )

private

按当前配置重建 BOS capability 缓存 Rebuild the BOS capability cache from the active configuration.

Definition at line 648 of file device_composition.cpp.

{
  // BOS capability 只从当前激活的 configuration 收集。
  // BOS capabilities are collected from the active configuration only.
  bos_.ClearCapabilities();
  const auto& config = CurrentConfigItems();
  for (size_t i = 0; i < config.item_num; ++i)
  {
    auto* item = config.items[i];
    if (item == nullptr)
    {
      continue;
    }
 
    const size_t capability_num = item->GetBosCapabilityCount();
    for (size_t j = 0; j < capability_num; ++j)
    {
      auto* cap = item->GetBosCapability(j);
      if (cap != nullptr)
      {
        bos_.AddCapability(cap);
      }
    }
  }
 
  (void)bos_.GetBosDescriptor();
}

◆ RegisterInterfaceStrings()

void DeviceComposition::RegisterInterfaceStrings ( )

private

为所有 class 分配并登记 interface string 索引 Allocate and register interface-string indices for all classes.

Definition at line 708 of file device_composition.cpp.

{
  if (interface_string_count_ == 0)
  {
    return;
  }
 
  // USB 字符串索引 1..3 保留给厂商/产品/序列号。
  // USB string indices 1..3 are reserved for manufacturer/product/serial.
  uint8_t next_index =
      static_cast<uint8_t>(DescriptorStrings::Index::SERIAL_NUMBER_STRING) + 1u;
  size_t registered_count = 0u;
 
  for (size_t class_index = 0; class_index < class_count_; ++class_index)
  {
    auto* device_class = classes_[class_index];
    if (device_class == nullptr)
    {
      continue;
    }
 
    const size_t interface_num = device_class->GetInterfaceCount();
    device_class->SetInterfaceStringBaseIndex(0u);
    bool class_has_string = false;
 
    for (size_t i = 0; i < interface_num; ++i)
    {
      const char* str = device_class->GetInterfaceString(i);
      if (str == nullptr || str[0] == '\0')
      {
        continue;
      }
 
      // 这里保留一张扁平源字符串表，
      // 这样 DeviceCore 之后按索引取接口字符串时，不必再重新遍历全部 class。
      // 保留一张扁平源字符串表，
      // 这样 DeviceCore 之后可以按索引重新生成任意接口字符串，而不必重扫全部 class。
      // Keep a flat source-string table so DeviceCore can later regenerate any
      // interface string by index without re-scanning all classes.
      ASSERT(registered_count < interface_string_count_);
      if (!class_has_string)
      {
        device_class->SetInterfaceStringBaseIndex(next_index);
        class_has_string = true;
      }
      interface_strings_[registered_count++] = str;
      ++next_index;
    }
  }
 
  ASSERT(registered_count == interface_string_count_);
}

◆ SwitchConfig()

LibXR::ErrorCode DeviceComposition::SwitchConfig	(	size_t	index,
		bool	in_isr )

切换到指定 configuration value Switch to the given configuration value.

Definition at line 428 of file device_composition.cpp.

{
  if (index > config_num_)
  {
    return LibXR::ErrorCode::NOT_FOUND;
  }
 
  if (index == 0)
  {
    UnbindEndpoints(in_isr);
    configured_ = false;
    current_cfg_ = 0;
    RebuildBosCache();
    return LibXR::ErrorCode::OK;
  }
 
  // USB configuration value 从 1 开始，而 current_cfg_ 内部保存的是从 0 开始的槽位。
  // USB configuration values are 1-based, while current_cfg_ stores a 0-based slot index.
  UnbindEndpoints(in_isr);
  current_cfg_ = static_cast<uint8_t>(index - 1);
  configured_ = true;
  BindEndpoints(in_isr);
  RebuildBosCache();
  return LibXR::ErrorCode::OK;
}

◆ TryOverrideDeviceDescriptor()

LibXR::ErrorCode DeviceComposition::TryOverrideDeviceDescriptor ( DeviceDescriptor & descriptor )

用当前配置覆盖 device descriptor 的类字段 Try to override device-descriptor class fields from the current configuration.

Definition at line 511 of file device_composition.cpp.

{
  if (config_num_ != 1)
  {
    return LibXR::ErrorCode::NOT_SUPPORT;
  }
 
  const auto config = items_[0];
  if (!is_device_descriptor_override_eligible(config.items, config.item_num))
  {
    return LibXR::ErrorCode::NOT_SUPPORT;
  }
 
  return config.items[0]->WriteDeviceDescriptor(descriptor);
}

◆ UnbindEndpoints()

void DeviceComposition::UnbindEndpoints ( bool in_isr )

private

解绑当前配置的全部端点 / Unbind all endpoints for the active configuration

Definition at line 625 of file device_composition.cpp.

{
  if (!ep_assigned_)
  {
    return;
  }
  ep_assigned_ = false;
 
  // Unbind 走的仍是当前激活 item 表，但这里不再需要重新分配接口号。
  // Unbind walks the same active item table, but no interface renumbering is needed here.
  const auto& config = CurrentConfigItems();
  for (size_t i = 0; i < config.item_num; ++i)
  {
    auto* item = config.items[i];
    if (item == nullptr)
    {
      continue;
    }
 
    item->UnbindEndpoints(endpoint_pool_, in_isr);
  }
}

Field Documentation

◆ bm_attributes_

uint8_t LibXR::USB::DeviceComposition::bm_attributes_ = CFG_BUS_POWERED

private

配置属性 / bmAttributes

Definition at line 179 of file device_composition.hpp.

◆ bos_

BosManager LibXR::USB::DeviceComposition::bos_

private

BOS 聚合管理 / BOS aggregation manager.

Definition at line 194 of file device_composition.hpp.

◆ class_count_

size_t LibXR::USB::DeviceComposition::class_count_ = 0

private

唯一 class 数量 / Unique class count

Definition at line 185 of file device_composition.hpp.

◆ classes_

DeviceClass** LibXR::USB::DeviceComposition::classes_ = nullptr

private

唯一 class 表 / Unique class table

Definition at line 184 of file device_composition.hpp.

◆ composite_

const bool LibXR::USB::DeviceComposition::composite_ = false

private

是否为复合设备 / Whether composite device

Definition at line 181 of file device_composition.hpp.

◆ config_desc_

ConfigDescriptor LibXR::USB::DeviceComposition::config_desc_

private

配置描述符构造器 / Configuration descriptor builder

Definition at line 195 of file device_composition.hpp.

◆ config_num_

const size_t LibXR::USB::DeviceComposition::config_num_ = 0

private

配置数量 / Configuration count

Definition at line 182 of file device_composition.hpp.

◆ configured_

bool LibXR::USB::DeviceComposition::configured_ = false

private

是否已进入非 0 配置态 / Whether a non-zero config is active

Definition at line 173 of file device_composition.hpp.

◆ current_cfg_

uint8_t LibXR::USB::DeviceComposition::current_cfg_ = 0

private

当前配置索引 / Current configuration index

Definition at line 177 of file device_composition.hpp.

◆ endpoint_pool_

EndpointPool& LibXR::USB::DeviceComposition::endpoint_pool_

private

端点池引用 / Endpoint pool reference

Definition at line 176 of file device_composition.hpp.

◆ ep_assigned_

bool LibXR::USB::DeviceComposition::ep_assigned_ = false

private

端点是否已绑定 / Whether endpoints are assigned

Definition at line 174 of file device_composition.hpp.

◆ i_configuration_

uint8_t LibXR::USB::DeviceComposition::i_configuration_ = 0

private

配置字符串索引 / Configuration string index

Definition at line 178 of file device_composition.hpp.

◆ interface_string_buffer_

RawData LibXR::USB::DeviceComposition::interface_string_buffer_

private

Initial value:

{

nullptr, 0}

临时字符串描述符缓冲区 / Temp interface string descriptor buffer

Definition at line 192 of file device_composition.hpp.

192 {

193 nullptr, 0};

◆ interface_string_count_

size_t LibXR::USB::DeviceComposition::interface_string_count_

private

Initial value:

=

0

接口字符串总数量 / Total interface string count

Definition at line 190 of file device_composition.hpp.

◆ interface_strings_

const char** LibXR::USB::DeviceComposition::interface_strings_

private

Initial value:

=

nullptr

接口字符串源表 / Interface string source table

Definition at line 188 of file device_composition.hpp.

◆ items_

ConfigItems* LibXR::USB::DeviceComposition::items_ = nullptr

private

配置项集合 / Configuration item set

Definition at line 183 of file device_composition.hpp.

◆ strings_

DescriptorStrings LibXR::USB::DeviceComposition::strings_

private

字符串描述符管理 / String descriptor manager

Definition at line 187 of file device_composition.hpp.

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

src/driver/usb/device/device_composition.hpp
src/driver/usb/device/device_composition.cpp

Data Structures

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ DeviceComposition()

Member Function Documentation

◆ BindEndpoints()

◆ BuildConfigDescriptor()

◆ CurrentConfigItems()

◆ Deinit()

◆ FindClassByEndpointAddress()

◆ FindClassByInterfaceNumber()

◆ GenerateInterfaceString()

◆ GetBosDescriptor()

◆ GetConfigDescriptor()

◆ GetConfigNum()

◆ GetCurrentConfig()

◆ GetDeviceStatus()

◆ GetStringDescriptor()

◆ Init()

◆ IsComposite()

◆ ProcessBosVendorRequest()

◆ RebuildBosCache()

◆ RegisterInterfaceStrings()

◆ SwitchConfig()

◆ TryOverrideDeviceDescriptor()

◆ UnbindEndpoints()

Field Documentation

◆ bm_attributes_

◆ bos_

◆ class_count_

◆ classes_

◆ composite_

◆ config_desc_

◆ config_num_

◆ configured_

◆ current_cfg_

◆ endpoint_pool_

◆ ep_assigned_

◆ i_configuration_

◆ interface_string_buffer_

◆ interface_string_count_

◆ interface_strings_

◆ items_

◆ strings_