Struct LinuxRs485Phy 

pub struct LinuxRs485Phy { /* private fields */ }

Linux userspace PHY implementation for UART TTY devices

Available with the phy-linux feature.

This PHY implementation is meant to be used with TTY devices configured for RS485 operation in Linux (Kernel Documentation).

For USB-RS485 converters, use crate::phy::SerialPortPhy (feature phy-serial) instead.

Considerations

Due to the non-realtime nature of Linux, you must use this PHY implementation with care. You may need to decrease the baudrate or lengthen timeouts (T_SL) to get reliable communication. You should also consider running your pogram at “real-time priority” to ensure low latency. It is advisable to run tests with heavy system load to ensure the bus communication stays reliable in all circumstances.

Example

use profirust::{Baudrate, fdl, dp, phy};
const BAUDRATE: Baudrate = Baudrate::B19200;

let mut fdl = fdl::FdlActiveStation::new(
    fdl::ParametersBuilder::new(0x02, BAUDRATE)
        // Increase T_slot (slot time)
        .slot_bits(1920)
        .build_verified(&dp_master)
);

let mut phy = phy::LinuxRs485Phy::new("/dev/ttyS0", fdl.parameters().baudrate);

Implementations

impl LinuxRs485Phy

pub fn new<P: AsRef<Path>>(serial_port: P, baudrate: Baudrate) -> Self

Construct and initialize a new PHY device

This function will attempt to configure the TTY device serial_port for PROFIBUS communication (line settings via termios and RS-485 mode when available).

pub fn wait_transmit(&mut self)

Wait/block until the current transmission completes.

This is useful to save CPU time as the PROFIBUS stack can’t do much anyway until the transmission is over.

Trait Implementations

impl Debug for LinuxRs485Phy

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

Formats the value using the given formatter.

impl ProfibusPhy for LinuxRs485Phy

fn poll_transmission(&mut self, _now: Instant) -> bool

Poll an ongoing transmission.

fn transmit_data<F, R>(&mut self, _now: Instant, f: F) -> R

where F: FnOnce(&mut [u8]) -> (usize, R),

Schedule transmission of some data.

fn receive_data<F, R>(&mut self, _now: Instant, f: F) -> R

where F: FnOnce(&[u8]) -> (usize, R),

Try receiving some data.

fn transmit_telegram<F>( &mut self, now: Instant, f: F, ) -> Option<TelegramTxResponse>

where F: FnOnce(TelegramTx<'_>) -> Option<TelegramTxResponse>,

Schedule transmission of a telegram.

fn receive_telegram<F, R>(&mut self, now: Instant, f: F) -> Option<R>

where F: FnOnce(Telegram<'_>) -> R,

Try receiving a telegram.

fn receive_all_telegrams<F, R>(&mut self, now: Instant, f: F) -> Option<R>

where F: FnMut(Telegram<'_>, bool) -> R,

Try receiving all pending telegrams.

fn poll_pending_received_bytes(&mut self, now: Instant) -> usize

Poll for the current amount of bytes waiting in the receive buffer.