libxtos-bcixtos_bci_session_create

xtos_bci_session_create

以 O_RDWR 打开 XTOS BCI 设备并创建会话,同时尝试缓存 GET_INFO 结果。

本页目录

声明

c
#include <xtos/bci.h>

xtos_bci_session_t *xtos_bci_session_create(const char *device_path);

参数

参数类型说明
device_pathconst char *非 NULL、NUL 结尾的设备节点路径,例如 /dev/xtos0。

返回值

成功返回会话句柄;失败返回 NULL 并保留分配或 open 的 errno。GET_INFO 失败不会使已打开的会话创建失败。

错误

errno条件
EINVALdevice_path 为 NULL。
ENOENT/EACCES/EBUSY设备节点不存在、权限不足或驱动不允许同时打开。
system errnocalloc 或 open 失败时返回相应 errno。

注意事项

  • 会话拥有 fd、设备路径和 mmap 状态;调用方只能通过 API 借用 fd/映射,不能自行 close/munmap。
  • GET_INFO 失败时 info 保持 calloc 的零值,后续 get_info 仍可能返回 0;创建成功不证明设备 UAPI 能力有效。
  • 同一会话的所有 API 必须由调用方串行化;SDK 无内部锁。调用可阻塞或分配,不能据此保证实时 deadline。
  • 创建时为 frame_read 预分配两份最多 292 条记录的 staging/published 缓冲,每份 65408 字节;任一分配失败会关闭 fd 并释放已有内存。

示例

源码

本文按 OpenXTOS v1.0.2(c24e923717670c4724cdaf24c7c105caee8dc2fb)的头文件和实现编写。