驱动分析

# 启用的驱动
#define BUILD_BASIC      // ✅ 已启用
#define BUILD_PTHREAD    // ✅ 已启用

# 其他设备驱动都是未启用的：
/* #undef BUILD_HSA */        // ❌ AMD GPU (HSA)
/* #undef BUILD_CUDA */       // ❌ NVIDIA GPU (CUDA)
/* #undef BUILD_ALMAIF */     // ❌ 硬件加速器
/* #undef BUILD_VULKAN */     // ❌ Vulkan 设备
/* #undef BUILD_LEVEL0 */     // ❌ Intel Level0 (GPU)
/* #undef BUILD_REMOTE_SERVER */
/* #undef BUILD_REMOTE_CLIENT */
/* #undef BUILD_PROXY */

设备名称: cpu-alderlake-12th Gen Intel(R) Core(TM) i5-12400

// 来自 pthread.c
void pocl_pthread_init_device_ops(struct pocl_device_ops *ops)
{
  pocl_basic_init_device_ops(ops);  // 继承 basic 的基础实现

  ops->device_name = "cpu";  // 设备名称

  // pthread 特有的多线程实现
  ops->probe = pocl_pthread_probe;
  ops->run = pocl_pthread_run;        // 多线程执行
  ops->join = pocl_pthread_join;
  ops->submit = pocl_pthread_submit;
  ops->notify = pocl_pthread_notify;
  // ...
}

// 来自 basic.c 注释
/**
 * The purpose of the 'basic' device driver is to serve as an example of
 * a minimalistic (but still working) device driver for pocl.
 * 
 * It is a "native device" without multithreading and uses malloc
 * directly for buffer allocation etc. It also executes work groups in
 * their sequential (increasing) order, thus makes it useful as a test
 * device.
 */

// 所有可用驱动的初始化函数数组
static init_device_ops pocl_devices_init_ops[] = {
#ifdef BUILD_BASIC
  INIT_DEV (basic),      // 位置 0
#endif
#ifdef BUILD_PTHREAD
  INIT_DEV (pthread),    // 位置 1
#endif
  // ... 其他驱动
};

// 驱动名称数组
char pocl_device_types[POCL_NUM_DEVICE_TYPES][30] = {
#ifdef BUILD_BASIC
  "basic",
#endif
#ifdef BUILD_PTHREAD
  "pthread",
#endif
  // ...
};

unsigned int
pocl_pthread_probe(struct pocl_device_ops *ops)
{
  int env_count = pocl_device_get_env_count(ops->device_name);

  /* 如果环境变量未指定，pthread 将被优先使用 */
  if(env_count < 0)
    return 1;  // 返回 1 表示找到 1 个设备

  return env_count;
}

unsigned int
pocl_basic_probe(struct pocl_device_ops *ops)
{
  int env_count = pocl_device_get_env_count(ops->device_name);

  /* 如果环境变量未指定，pthread 将被优先使用，basic 返回 0 */
  if(env_count < 0)
    return 0;  // basic 主动让位给 pthread

  return env_count;
}