Enum Resolution 

pub enum Resolution {
    Bits9,
    Bits10,
    Bits11,
    Bits12,
}

The conversion resolution, selected by the R1/R0 bits of the configuration byte.

Higher resolution resolves smaller steps but takes longer to convert, a tradeoff the datasheet spells out. The temperature register always carries 1/16 °C per count; at lower resolutions the unused low bits simply read as zero.

Variants

Bits9

9-bit, 0.5 °C steps, up to 93.75 ms per conversion.

Bits10

10-bit, 0.25 °C steps, up to 187.5 ms per conversion.

Bits11

11-bit, 0.125 °C steps, up to 375 ms per conversion.

Bits12

12-bit, 0.0625 °C steps, up to 750 ms per conversion. The power-on default.

Implementations

impl Resolution

pub fn bits(self) -> u8

Returns the number of significant bits this resolution produces.

Returns

9, 10, 11, or 12.

pub fn config_byte(self) -> u8

Returns the configuration-register byte that selects this resolution.

The byte places R1/R0 in bits 6:5 over the datasheet’s fixed surrounding pattern (bit 7 clear, bit 4 set, bits 3:0 set), so 12-bit is 0x7F, 11-bit 0x5F, 10-bit 0x3F, and 9-bit 0x1F.

Returns

The configuration byte written to scratchpad byte 4.

pub fn from_config_byte(byte: u8) -> Resolution

Reads the resolution out of a configuration byte’s R1/R0 bits.

Arguments

• byte - the configuration register (scratchpad byte 4).

Returns

The resolution selected by bits 6:5.

pub fn step_micro_celsius(self) -> u32

Returns the temperature step this resolution resolves, in micro-degrees Celsius.

Returns

500000 (0.5 °C) for 9-bit down to 62500 (0.0625 °C) for 12-bit.

pub fn max_conversion_micros(self) -> u32

Returns the datasheet’s maximum conversion time, in microseconds.

Returns

93750 for 9-bit, doubling up to 750000 for 12-bit.

Trait Implementations

impl Clone for Resolution

fn clone(&self) -> Resolution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Resolution

impl Debug for Resolution

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

Formats the value using the given formatter.

impl Eq for Resolution

impl PartialEq for Resolution

fn eq(&self, other: &Resolution) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Resolution