Trait OneWireAsync

pub trait OneWireAsync {
    type Status: OneWireStatus;
    type BusError;

    // Required methods
    async fn reset(&mut self) -> OneWireResult<Self::Status, Self::BusError>;
    async fn write_byte(
        &mut self,
        byte: u8,
    ) -> OneWireResult<(), Self::BusError>;
    async fn read_byte(&mut self) -> OneWireResult<u8, Self::BusError>;
    async fn write_bit(
        &mut self,
        bit: bool,
    ) -> OneWireResult<(), Self::BusError>;
    async fn read_bit(&mut self) -> OneWireResult<bool, Self::BusError>;
    async fn get_overdrive_mode(
        &mut self,
    ) -> OneWireResult<bool, Self::BusError>;

    // Provided method
    async fn set_overdrive_mode(
        &mut self,
        _enable: bool,
    ) -> OneWireResult<(), Self::BusError> { ... }
}

Trait for 1-Wire communication. This trait defines the basic operations required for 1-Wire communication, such as resetting the bus, writing and reading bytes, and writing and reading bits.

Required Associated Types

type Status: OneWireStatus

The status type returned by the reset operation. This type must implement the OneWireStatus trait.

type BusError

The error type returned by the operations of this trait. This type is used to indicate errors in the underlying hardware or communication.

Required Methods

async fn reset(&mut self) -> OneWireResult<Self::Status, Self::BusError>

Resets the 1-Wire bus and returns the status of the bus.

Returns

A result containing the status of the bus after the reset operation.

Errors

This method returns an error if the reset operation fails.

async fn write_byte(&mut self, byte: u8) -> OneWireResult<(), Self::BusError>

Writes a byte to the 1-Wire bus.

Arguments

• byte - The byte to write to the bus.

Errors

This method returns an error if the write operation fails.

async fn read_byte(&mut self) -> OneWireResult<u8, Self::BusError>

Reads a byte from the 1-Wire bus.

Returns

Byte read from the bus.

Errors

This method returns an error if the read operation fails.

async fn write_bit(&mut self, bit: bool) -> OneWireResult<(), Self::BusError>

Reads a byte from the 1-Wire bus, with an option to write a byte before reading.

Arguments

• bit - The byte to write.

Errors

This method returns an error if the read operation fails.

async fn read_bit(&mut self) -> OneWireResult<bool, Self::BusError>

Reads a single bit from the 1-Wire bus.

Returns

The bit read from the bus.

Errors

This method returns an error if the read operation fails.

async fn get_overdrive_mode(&mut self) -> OneWireResult<bool, Self::BusError>

Check if the 1-Wire bus is in overdrive mode.

Returns

A result containing a boolean indicating whether the bus is in overdrive mode.

Provided Methods

async fn set_overdrive_mode( &mut self, _enable: bool, ) -> OneWireResult<(), Self::BusError>

Set the 1-Wire bus to overdrive mode.

Arguments

• enable - A boolean indicating whether to enable or disable overdrive mode.

Returns

A result indicating the success or failure of the operation.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors