xtos_ bci_ set_ channel
通过 ioctl 请求启用或禁用一个通道并传入增益字段。
本页目录
声明
#include <xtos/bci.h>
int xtos_bci_set_channel(xtos_bci_session_t *session,
uint32_t channel,
bool enabled,
uint32_t gain);参数
| 参数 | 类型 | 说明 |
|---|---|---|
| session | xtos_bci_session_t * | 非 NULL 会话句柄。 |
| channel | uint32_t | 通道索引;有效范围由驱动决定。 |
| enabled | bool | 是否启用通道。 |
| gain | uint32_t | 增益值字段;用户态构造并传给 ioctl。 |
返回值
返回底层 ioctl 的 0 或 -1;SDK 不更新设备信息缓存。
错误
| errno | 条件 |
|---|---|
| EINVAL | session 为 NULL,或驱动认为通道配置无效。 |
| ENOTTY/EOPNOTSUPP | 设备不支持通道配置。 |
| system errno | ioctl 失败时返回驱动或系统 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)的头文件和实现编写。