libxtos-bcixtos_bci_set_sampling_rate

xtos_bci_set_sampling_rate

通过 ioctl 请求设备使用指定整数采样率,并在成功后更新会话缓存。

本页目录

声明

c
#include <xtos/bci.h>

int xtos_bci_set_sampling_rate(xtos_bci_session_t *session, uint32_t rate);

参数

参数类型说明
sessionxtos_bci_session_t *非 NULL 会话句柄。
rateuint32_t采样率,单位 Hz;库本身不检查设备支持列表。

返回值

ioctl 成功返回 0 并更新 info.sampling_rate;失败返回 -1且不更新缓存。

错误

errno条件
EINVALsession 为 NULL,或驱动认为 rate 无效。
ENOTTY/EOPNOTSUPP设备不支持设置采样率。
system errnoioctl 失败时返回驱动或系统 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)的头文件和实现编写。