Struct UltrasonicSensor

pub struct UltrasonicSensor { /* private fields */ }

LEGO EV3 ultrasonic sensor.

Implementations

impl UltrasonicSensor

pub const MODE_US_DIST_CM: &'static str = "US-DIST-CM"

Continuous measurement - sets LEDs on, steady. Units in centimeters. Distance (0-2550)

pub const MODE_US_DIST_IN: &'static str = "US-DIST-IN"

Continuous measurement - sets LEDs on, steady. Units in inches. Distance (0-1003)

pub const MODE_US_LISTEN: &'static str = "US-LISTEN"

Listen - sets LEDs on, blinking. Presence (0-1) #

pub const MODE_US_SI_CM: &'static str = "US-SI-CM"

Single measurement - LEDs on momentarily when mode is set, then off. Units in centimeters. Distance (0-2550)

pub const MODE_US_SI_IN: &'static str = "US-SI-IN"

Single measurement - LEDs on momentarily when mode is set, then off. Units in inches. Distance (0-1003)

pub const MODE_US_DC_CM: &'static str = "US-DC-CM"

??? - sets LEDs on, steady. Units in centimeters. Distance (0-2550)

pub const MODE_US_DC_IN: &'static str = "US-DC-IN"

??? - sets LEDs on, steady. Units in inches. Distance (0-1003)

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_us_dist_cm(&self) -> Ev3Result<()>

Continuous measurement - sets LEDs on, steady. Units in centimeters. Distance (0-2550)

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

Continuous measurement - sets LEDs on, steady. Units in centimeters. Distance (0-2550)

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

Continuous measurement - sets LEDs on, steady. Units in inches. Distance (0-1003)

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

Continuous measurement - sets LEDs on, steady. Units in inches. Distance (0-1003)

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

Listen - sets LEDs on, blinking. Presence (0-1) #

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

Listen - sets LEDs on, blinking. Presence (0-1) #

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

Single measurement - LEDs on momentarily when mode is set, then off. Units in centimeters. Distance (0-2550)

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

Single measurement - LEDs on momentarily when mode is set, then off. Units in centimeters. Distance (0-2550)

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

Single measurement - LEDs on momentarily when mode is set, then off. Units in inches. Distance (0-1003)

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

Single measurement - LEDs on momentarily when mode is set, then off. Units in inches. Distance (0-1003)

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

??? - sets LEDs on, steady. Units in centimeters. Distance (0-2550)

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

??? - sets LEDs on, steady. Units in centimeters. Distance (0-2550)

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

??? - sets LEDs on, steady. Units in inches. Distance (0-1003)

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

??? - sets LEDs on, steady. Units in inches. Distance (0-1003)

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

Measurement of the distance detected by the sensor, unscaled.

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

Measurement of the distance detected by the sensor, in centimeters.

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

Measurement of the distance detected by the sensor, in inches.

Trait Implementations

impl Clone for UltrasonicSensor

fn clone(&self) -> UltrasonicSensor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UltrasonicSensor

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

Formats the value using the given formatter.

impl Device for UltrasonicSensor

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 UltrasonicSensor

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.