┌──────────────────────────────────────────────────────────────┐
│  PoCL 核心层 (你不需要写)                                      │
│  ✅ 350 行代码已实现                                           │
│  - 参数验证 (flags, size, context 等)                         │
│  - cl_mem 对象分配和管理                                      │
│  - 标志位逻辑 (USE_HOST_PTR, COPY_HOST_PTR...)               │
│  - 引用计数和版本追踪                                         │
│  - 错误处理框架                                               │
└──────────────────────────────────────────────────────────────┘
                             ↓
┌──────────────────────────────────────────────────────────────┐
│  设备驱动层 (你只需要写这部分)                                 │
│  ⚠️ ~100 行核心代码                                            │
│  - alloc_mem_obj()    50-80 行 (必须)                        │
│  - free()             10-20 行 (必须)                        │
│  - read/write         各 20-30 行 (可选,独立显存需要)          │
└──────────────────────────────────────────────────────────────┘

cl_int pocl_yourdevice_alloc_mem_obj(...) {
    // 1. 让 PoCL 分配主机内存
    if ((mem->flags & CL_MEM_ALLOC_HOST_PTR) && !mem->mem_host_ptr)
        return CL_MEM_OBJECT_ALLOCATION_FAILURE;

    pocl_alloc_or_retain_mem_host_ptr(mem);

    // 2. 设备地址 = 主机地址 (统一地址空间的关键!)
    p->mem_ptr = mem->mem_host_ptr;
    p->device_addr = mem->mem_host_ptr;
    p->version = mem->mem_host_ptr_version;

    return CL_SUCCESS;
}

cl_int pocl_yourdevice_alloc_mem_obj(...) {
    // 1. 在设备上分配显存
    void *device_ptr = yourdevice_malloc(device_handle, mem->size);
    if (!device_ptr)
        return CL_OUT_OF_RESOURCES;

    p->mem_ptr = device_ptr;
    p->device_addr = device_ptr;
    p->version = 0;

    // 2. 如果需要立即拷贝数据
    if ((mem->flags & CL_MEM_COPY_HOST_PTR) && host_ptr) {
        yourdevice_memcpy_h2d(device_ptr, host_ptr, size);
        p->version = 1;
    }

    // 3. 如果需要主机缓冲区
    if (mem->flags & CL_MEM_ALLOC_HOST_PTR) {
        pocl_alloc_or_retain_mem_host_ptr(mem);
    }

    return CL_SUCCESS;
}

void pocl_yourdevice_read(...) {
    yourdevice_memcpy_d2h(host_ptr, device_ptr + offset, size);
}

void pocl_yourdevice_write(...) {
    yourdevice_memcpy_h2d(device_ptr + offset, host_ptr, size);
}

cl_int pocl_yourdevice_alloc_mem_obj(...) {
    // 1. 发送远程分配请求
    remote_request_t req = { .type = ALLOC, .size = mem->size };
    remote_response_t resp;
    send_request(device_socket, &req, &resp);

    if (resp.status != SUCCESS)
        return CL_OUT_OF_RESOURCES;

    // 2. 保存远程地址 (可能只是一个句柄)
    p->mem_ptr = (void*)resp.remote_address;
    p->device_addr = p->mem_ptr;
    p->version = 0;

    // 3. 初始数据传输
    if ((mem->flags & CL_MEM_COPY_HOST_PTR) && host_ptr) {
        send_data_transfer(device_socket, resp.remote_address, 
                          host_ptr, mem->size);
        p->version = 1;
    }

    return CL_SUCCESS;
}

cd /home/ken/workspace/pocl/lib/CL/devices
cp -r basic yourdevice
cd yourdevice
mv basic.c yourdevice.c
mv basic.h yourdevice.h

# 全局替换 "basic" 为 "yourdevice"
sed -i 's/basic/yourdevice/g' *.c *.h CMakeLists.txt
sed -i 's/BASIC/YOURDEVICE/g' *.c *.h

void pocl_yourdevice_init_device_ops(struct pocl_device_ops *ops)
{
    // ... 这里设置函数指针
    ops->alloc_mem_obj = pocl_yourdevice_alloc_mem_obj;  // ← 实现这个
    ops->free = pocl_yourdevice_free;                     // ← 实现这个
}

# 找到类似这样的行:
option(ENABLE_YOURDEVICE "Enable YourDevice driver" ON)

# 添加子目录
if(ENABLE_YOURDEVICE)
  add_subdirectory(lib/CL/devices/yourdevice)
endif()

cd /home/ken/workspace/pocl/build
cmake .. -DENABLE_YOURDEVICE=ON
make -j$(nproc)

# 测试
export POCL_DEVICES="yourdevice"
./tests/runtime/test_clCreateBuffer

// ❌ 错误: 只设置了 mem_ptr
p->mem_ptr = device_ptr;

// ✅ 正确: 两个都要设置
p->mem_ptr = device_ptr;
p->device_addr = device_ptr;  // 通常与 mem_ptr 相同

// ❌ 错误: 拷贝了数据但没更新版本
yourdevice_memcpy_h2d(device_ptr, host_ptr, size);
// p->version 仍是 0!

// ✅ 正确: 更新版本号
yourdevice_memcpy_h2d(device_ptr, host_ptr, size);
p->version = 1;  // ← 标记数据已同步

// ❌ 错误: 直接分配内存
mem->mem_host_ptr = malloc(size);

// ✅ 正确: 使用 PoCL 提供的函数 (自动管理引用计数)
pocl_alloc_or_retain_mem_host_ptr(mem);

// ❌ 错误: 没有处理这个标志
if (mem->flags & CL_MEM_ALLOC_HOST_PTR) {
    // 什么都不做 → 可能导致 mem_host_ptr 为 NULL
}

// ✅ 正确: 确保主机内存已分配
if (mem->flags & CL_MEM_ALLOC_HOST_PTR) {
    pocl_alloc_or_retain_mem_host_ptr(mem);
}

typedef struct pocl_mem_identifier {
    void *mem_ptr;           // ← 你必须设置: 设备内存指针
    void *device_addr;       // ← 你必须设置: 设备地址 (通常 == mem_ptr)
    unsigned version;        // ← 你必须管理: 数据版本号
    int is_pinned;           // ← 可选: 标记固定内存
    // ... 其他字段 (PoCL 管理)
} pocl_mem_identifier;

pocl_mem_identifier *p = &mem->device_ptrs[device->global_mem_id];

struct _cl_mem {
    size_t size;                  // ✅ 已设置: 缓冲区大小
    cl_mem_flags flags;           // ✅ 已设置: 内存标志
    void *mem_host_ptr;           // ✅ 可能已设置 (USE_HOST_PTR, COPY_HOST_PTR)
    unsigned mem_host_ptr_version; // ✅ 已管理: 主机端版本
    unsigned mem_host_ptr_refcount; // ✅ 已管理: 引用计数
    pocl_mem_identifier *device_ptrs; // ← 你的设备对应的元素
    // ...
};