xtos_ bci_ set_ sampling_ rate
通过 ioctl 请求设备使用指定整数采样率,并在成功后更新会话缓存。
本页目录
声明
#include <xtos/bci.h>
int xtos_bci_set_sampling_rate(xtos_bci_session_t *session, uint32_t rate);参数
| 参数 | 类型 | 说明 |
|---|---|---|
| session | xtos_bci_session_t * | 非 NULL 会话句柄。 |
| rate | uint32_t | 采样率,单位 Hz;库本身不检查设备支持列表。 |
返回值
ioctl 成功返回 0 并更新 info.sampling_rate;失败返回 -1且不更新缓存。
错误
| errno | 条件 |
|---|---|
| EINVAL | session 为 NULL,或驱动认为 rate 无效。 |
| ENOTTY/EOPNOTSUPP | 设备不支持设置采样率。 |
| system errno | ioctl 失败时返回驱动或系统 errno。 |
注意事项
- 固定 Cyton 路径只支持 250 Hz:停止状态下执行寄存器回读并验证/提交配置,不发送会重置全部 ADS 状态的 ~6。500、1000、2000 Hz 返回 EOPNOTSUPP;其他值 EINVAL;活动接收时 EBUSY。
- 同一会话的所有 API 必须由调用方串行化;SDK 无内部锁。调用可阻塞或分配,不能据此保证实时 deadline。
- SDK 仅在 ioctl 成功后更新 info.sampling_rate;Cyton 驱动成功表示已验证回读并提交配置,失败可使配置失效。使用 get_config 获取已验证代次;源码实现不等于物理采样率实测。
示例
源码
本文按 OpenXTOS v1.0.2(c24e923717670c4724cdaf24c7c105caee8dc2fb)的头文件和实现编写。