Struct LightSensor

pub struct LightSensor { /* private fields */ }

LEGO EV3 light sensor.

Implementations

impl LightSensor

pub const MODE_REFLECT: &'static str = "REFLECT"

Reflected light. LED on

pub const MODE_AMBIENT: &'static str = "AMBIENT"

Ambient light. LED off

pub fn get(port: SensorPort) -> Ev3Result<Self>

Try to get a Self on the given port. Returns None if port is not used or another device is connected.

pub fn find() -> Ev3Result<Self>

Try to find a Self. Only returns a motor if their is exactly one connected, Error::NotFound otherwise.

pub fn list() -> Ev3Result<Vec<Self>>

Extract list of connected ‘Self’

pub fn set_mode_reflect(&self) -> Ev3Result<()>

Reflected light. LED on

pub fn is_mode_reflect(&self) -> Ev3Result<bool>

Reflected light. LED on

pub fn set_mode_ambient(&self) -> Ev3Result<()>

Ambient light. LED off

pub fn is_mode_ambient(&self) -> Ev3Result<bool>

Ambient light. LED off

pub fn get_light_intensity(&self) -> Ev3Result<i32>

A measurement of the light intensity, unscaled.

pub fn get_reflected_light_intensity(&self) -> Ev3Result<f32>

A measurement of the reflected light intensity, as a percentage.

pub fn get_ambient_light_intensity(&self) -> Ev3Result<f32>

A measurement of the ambient light intensity, as a percentage.

Trait Implementations

impl Clone for LightSensor

fn clone(&self) -> LightSensor

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LightSensor

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Device for LightSensor

fn get_attribute(&self, name: &str) -> Attribute

Returns the attribute wrapper for an attribute name.

fn get_address(&self) -> Ev3Result<String>

Returns the name of the port that the motor is connected to.

fn set_command(&self, command: &str) -> Ev3Result<()>

Sends a command to the device controller.

fn get_commands(&self) -> Ev3Result<Vec<String>>

Returns a space separated list of commands that are supported by the device controller.

fn get_driver_name(&self) -> Ev3Result<String>

Returns the name of the driver that provides this device.

impl Sensor for LightSensor

fn get_bin_data(&self) -> Ev3Result<String>

Reading the file will give the unscaled raw values in the value<N> attributes. Use bin_data_format, num_values and the individual sensor documentation to determine how to interpret the data.

fn get_bin_data_format(&self) -> Ev3Result<String>

Returns the format of the values in bin_data for the current mode. Possible values are:

fn get_decimals(&self) -> Ev3Result<i32>

Returns the number of decimal places for the values in the value<N> attributes of the current mode.

fn get_fw_version(&self) -> Ev3Result<String>

Returns the firmware version of the sensor if available. Currently only NXT/I2C sensors support this.

fn get_mode(&self) -> Ev3Result<String>

Returns the current mode. See the individual sensor documentation for a description of the modes available for each type of sensor.

fn set_mode(&self, mode: &str) -> Ev3Result<()>

Sets the sensor to that mode. See the individual sensor documentation for a description of the modes available for each type of sensor.

fn get_modes(&self) -> Ev3Result<Vec<String>>

Returns a list of the valid modes for the sensor.

fn get_num_values(&self) -> Ev3Result<i32>

Returns the number of value<N> attributes that will return a valid value for the current mode.

fn get_poll_ms(&self) -> Ev3Result<i32>

Returns the polling period of the sensor in milliseconds. Returns -EOPNOTSUPP if changing polling is not supported. Note: Setting poll_ms too high can cause the input port auto detection to fail. If this happens, use the mode attribute of the port to force the port to nxt-i2c mode. Values must not be negative.

fn set_poll_ms(&self, poll_ms: i32) -> Ev3Result<()>

Sets the polling period of the sensor in milliseconds. Setting to 0 disables polling. Note: Setting poll_ms too high can cause the input port auto detection to fail. If this happens, use the mode attribute of the port to force the port to nxt-i2c mode. Values must not be negative.

fn get_units(&self) -> Ev3Result<String>

Returns the units of the measured value for the current mode. May return empty string if units are unknown.

fn get_value(&self, index: u8) -> Ev3Result<i32>

Returns the current value{index} value if available.

fn get_value0(&self) -> Ev3Result<i32>

Returns the current value0 value if available.

fn get_value1(&self) -> Ev3Result<i32>

Returns the current value1 value if available.

fn get_value2(&self) -> Ev3Result<i32>

Returns the current value2 value if available.

fn get_value3(&self) -> Ev3Result<i32>

Returns the current value3 value if available.

fn get_value4(&self) -> Ev3Result<i32>

Returns the current value4 value if available.

fn get_value5(&self) -> Ev3Result<i32>

Returns the current value5 value if available.

fn get_value6(&self) -> Ev3Result<i32>

Returns the current value6 value if available.

fn get_value7(&self) -> Ev3Result<i32>

Returns the current value7 value if available.

fn get_text_value(&self) -> Ev3Result<String>

Returns a space delimited string representing sensor-specific text values. Returns -EOPNOTSUPP if a sensor does not support text values.