これは開発版のドキュメントである. 内容は次のリリースまでに変更される可能性がある. 最新のリリース版は 0.14.x を参照.
SamplingConfig
SamplingConfig は Modulation や STM のサンプリング周波数を表す.
サンプリング周波数は超音波周波数 (40 kHz) を整数で分周した値でなければならない.
SamplingConfig::new(NonZeroU16::new(10).unwrap());SamplingConfig::from_freq(4. * kHz)?;SamplingConfig::from_period(Duration::from_micros(250))?;SamplingConfig(10)SamplingConfig(4.0 * kHz)SamplingConfig(Duration.from_micros(250))new SamplingConfig(10);new SamplingConfig(4.0f * kHz);new SamplingConfig(TimeSpan.FromMicroseconds(250));上記はいずれも 4 kHz (分周比 10) を表し, 互いに等価.
SamplingConfig は内部では最終的に分周比 (u16) へ変換される.
分周比
周波数・周期で指定した場合, それが 40 kHz を割り切れない (整数の分周比にならない) とエラーになる.
よく使う定数はあらかじめ用意されている.
| 定数 | サンプリング周波数 | 分周比 |
|---|---|---|
FREQ_40K |
40 kHz | 1 |
FREQ_4K |
4 kHz | 10 |