Module capsules::humidity

Provides userspace with access to humidity 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 humidity reading. The subscribecall return codes indicate the following:

• SUCCESS: the callback been successfully been configured.
• ENOSUPPORT: Invalid allow_num.
• ENOMEM: No sufficient memory available.
• EINVAL: 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 exist
• 1: read humidity

The possible return from the 'command' system call indicates the following:

• SUCCESS: The operation has been successful.
• EBUSY: The driver is busy.
• ENOSUPPORT: Invalid cmd.
• ENOMEM: No sufficient memory available.
• EINVAL: Invalid address of the buffer or other error.

Usage

You need a device that provides the hil::sensors::HumidityDriver trait.

let humidity = static_init!(
       capsules::humidity::HumiditySensor<'static>,
       capsules::humidity::HumiditySensor::new(si7021,
                                                kernel::Grant::create()), 96/8);
kernel::hil::sensors::HumidityDriver::set_client(si7021, humidity);

Reexports

use core::cell::Cell;

use kernel::AppId;

use kernel::Callback;

use kernel::Driver;

use kernel::Grant;

use kernel::ReturnCode;

use kernel::hil;

Structs

App
HumiditySensor

Enums

HumidityCommand

Constants

DRIVER_NUM

Syscall number