为何OpenCL中write_imageh将向量数据写入非预期位置？（Mali-G77测试）

问题背景 #

在Mali-G77 MC9移动GPU上开展OpenCL通用矩阵乘法测试时，出现2D Image写入位置异常：

• 主机端创建了宽2、高8的CL_RGBA格式2D Image
• Kernel中通过write_imageh，分别向坐标(0,0)、(0,1)、(1,0)、(1,1)写入half4(1)、half4(2)、half4(3)、half4(4)
• 实际读取结果：1在(0,0)、3在(1,0)符合预期，但2出现在(0,4)、4出现在(1,4)，y坐标偏移了4个单位

排查方向与解决建议 #

1. 内存映射时未正确处理行间距(pitch) #

这是最可能的原因：Mali GPU驱动会对Image内存做硬件对齐优化，实际行间距（row_pitch）可能远大于你预期的宽度*像素大小。

• 调用clEnqueueMapImage时，必须使用驱动返回的row_pitch参数计算主机端内存偏移，不能直接按连续内存遍历。
• 错误示例：直接用y * width * sizeof(half4) + x * sizeof(half4)计算偏移
• 正确方式：y * row_pitch + x * sizeof(half4)
• 你的现象刚好符合行间距是预期4倍的情况——假设驱动把行间距对齐到了64字节（对应8个half4像素），写入(0,1)的内容会被存在row_pitch*1的位置，而如果按连续内存读取，这个位置会被误判为(0,4)。

2. 检查Image创建时的参数匹配 #

• 确认cl_image_format的正确性：image_channel_order为CL_RGBA，image_channel_data_type必须是CL_HALF_FLOAT，类型不匹配会导致数据解析错位。
• 检查cl_image_desc的image_type是否为CL_MEM_OBJECT_IMAGE2D，避免误创建为3D Image或带深度的Image。
• 确认image_height参数确实设置为8，没有被误写为4或其他值。

3. Kernel中坐标参数的类型与正确性 #

• 确保write_imageh的坐标参数是int2类型，避免使用float2等类型隐式转换导致的坐标截断或偏移。
• 验证Kernel中使用的坐标值，确认传入的(0,1)等坐标没有被错误修改。

4. 驱动版本与编译优化问题 #

• 升级Mali OpenCL驱动到最新稳定版，旧版本可能存在Image坐标映射的已知bug。
• 关闭Kernel编译时的激进优化选项（比如-cl-fast-relaxed-math），重新编译测试，排除优化导致的坐标计算错误。

内容的提问来源于stack exchange，提问作者walter