Expand description
Provides userspace with access to temperature sensors.
§Userspace Interface
§subscribe System Call
The subscribe system call supports the single subscribe_number zero,
which is used to provide a callback that will return back the result of
a temperature sensor reading.
The subscribecall return codes indicate the following:
Ok(()): the callback been successfully been configured.ENOSUPPORT: Invalid allow_num.NOMEM: No sufficient memory available.INVAL: Invalid address of the buffer or other error.
§command System Call
The command system call support one argument cmd which is used to
specify the specific operation, currently the following cmd’s are supported:
0: check whether the driver exists1: read the temperature
The possible return from the ‘command’ system call indicates the following:
Ok(()): The operation has been successful.NOSUPPORT: Invalidcmd.NOMEM: Insufficient memory available.INVAL: Invalid address of the buffer or other error.
§Usage
You need a device that provides the hil::sensors::TemperatureDriver trait.
ⓘ
let grant_cap = create_capability!(capabilities::MemoryAllocationCapability);
let grant_temperature = board_kernel.create_grant(&grant_cap);
let temp = static_init!(
capsules::temperature::TemperatureSensor<'static>,
capsules::temperature::TemperatureSensor::new(si7021,
board_kernel.create_grant(&grant_cap)));
kernel::hil::sensors::TemperatureDriver::set_client(si7021, temp);