libxtos-bcixtos_bci_set_channel

xtos_bci_set_channel

通过 ioctl 请求启用或禁用一个通道并传入增益字段。

本页目录

声明

c
#include <xtos/bci.h>

int xtos_bci_set_channel(xtos_bci_session_t *session,
                        uint32_t channel,
                        bool enabled,
                        uint32_t gain);

参数

参数类型说明
sessionxtos_bci_session_t *非 NULL 会话句柄。
channeluint32_t通道索引;有效范围由驱动决定。
enabledbool是否启用通道。
gainuint32_t增益值字段;用户态构造并传给 ioctl。

返回值

返回底层 ioctl 的 0 或 -1;SDK 不更新设备信息缓存。

错误

errno条件
EINVALsession 为 NULL,或驱动认为通道配置无效。
ENOTTY/EOPNOTSUPP设备不支持通道配置。
system errnoioctl 失败时返回驱动或系统 errno。

注意事项

  • 固定 core/Cyton 路径已接线 gain:允许 1, 2, 4, 6, 8, 12, 24;0 表示保留回读增益。Cyton 通道索引 0..7,活动接收时 EBUSY。发送 9 字节 x...X 命令,精确核对 ACK,再回读寄存器与期望值比较,成功后提交新配置代次。
  • 同一会话的所有 API 必须由调用方串行化;SDK 无内部锁。调用可阻塞或分配,不能据此保证实时 deadline。
  • 参数结构仅在调用期间使用;不保留指针。未知增益 EINVAL;不支持的共享 BIAS/SRB1 状态 EOPNOTSUPP。传输/回读失败使配置失效,不保证回滚;先 get_config 核验再恢复采集。旧驱动若只有 enable callback,不会静默忽略非零 gain,而返回 EOPNOTSUPP。

示例

源码

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