Problem
Continuous and one-shot mode methods use inconsistent names across drivers.
| Driver |
Set continuous |
Set one-shot |
Trigger |
Read one-shot |
| wsen-hids |
set_continuous_mode(odr) |
set_one_shot_mode() |
trigger_one_shot() |
read_one_shot() |
| wsen-pads |
set_continuous(odr) |
(implicit via power_down()) |
trigger_one_shot() |
read_one_shot() |
| hts221 |
setODR(odr) |
(none) |
(none, PR #68 adds trigger_one_shot()) |
(none) |
| lis2mdl |
set_mode("continuous") |
set_mode("single") |
(none) |
(none) |
Proposed convention
set_continuous(odr=...): start continuous measurements at given rate
trigger_one_shot(): trigger a single conversion (sensor must be in power-down/one-shot mode)
read_one_shot(): trigger + wait + return data
- No separate
set_one_shot_mode() needed if trigger_one_shot() handles it internally
wsen-hids and wsen-pads are already close to this convention.
Drivers to update
Dependencies
Problem
Continuous and one-shot mode methods use inconsistent names across drivers.
set_continuous_mode(odr)set_one_shot_mode()trigger_one_shot()read_one_shot()set_continuous(odr)power_down())trigger_one_shot()read_one_shot()setODR(odr)trigger_one_shot())set_mode("continuous")set_mode("single")Proposed convention
set_continuous(odr=...): start continuous measurements at given ratetrigger_one_shot(): trigger a single conversion (sensor must be in power-down/one-shot mode)read_one_shot(): trigger + wait + return dataset_one_shot_mode()needed iftrigger_one_shot()handles it internallywsen-hids and wsen-pads are already close to this convention.
Drivers to update
set_continuous(odr)wrapper, keepsetODR()as legacy aliasset_continuous(odr)andtrigger_single()/trigger_one_shot()set_continuous()already compliantset_continuous_mode()→set_continuous()for consistency with wsen-padsDependencies
setODR)