Struct Wiring 

pub struct Wiring {
    pub spi: PathBuf,
    pub spi_hz: u32,
    pub gpio_chip: PathBuf,
    pub reset_line: u32,
    pub busy_line: Option<u32>,
    pub power_enable_line: Option<u32>,
}

Where a radio module is wired on a Linux board.

Examples

use pamoja_radios::linux::{Wiring, DEFAULT_SPI_HZ};

// An SX1262 board on SPI0's second chip select, BUSY on GPIO24 and reset on GPIO25.
let wiring = Wiring::new("/dev/spidev0.1", "/dev/gpiochip0", 25).with_busy_line(24);
assert_eq!(wiring.busy_line, Some(24));
assert_eq!(wiring.spi_hz, DEFAULT_SPI_HZ);

Fields

spi: PathBuf

The SPI device file, one per chip select, such as /dev/spidev0.0.

spi_hz: u32

The SPI clock in hertz.

gpio_chip: PathBuf

The GPIO chip the lines are on, /dev/gpiochip0 for a Raspberry Pi’s header.

reset_line: u32

The line the module’s reset pin is on: its offset on the chip, which on a Raspberry Pi is the BCM GPIO number.

busy_line: Option<u32>

The line an SX126x’s BUSY pin is on. The SX127x has no BUSY pin.

power_enable_line: Option<u32>

The line that switches a concentrator’s supply on, for a board that gates it.

A card wired this way answers nothing at all until the line is raised, and it has to stay raised for as long as the card is used.

Implementations

impl Wiring

pub fn new( spi: impl Into<PathBuf>, gpio_chip: impl Into<PathBuf>, reset_line: u32, ) -> Wiring

Describes a module on an SPI device with its reset pin on a GPIO line, clocked at DEFAULT_SPI_HZ and with no BUSY line.

Arguments

• spi - the SPI device file.
• gpio_chip - the GPIO chip the lines are on.
• reset_line - the line the reset pin is on.

Returns

The wiring.

pub fn with_power_enable_line(self, line: u32) -> Wiring

Returns the wiring with a concentrator’s supply gated behind a line.

Arguments

• line - the line that switches the supply on.

Returns

The wiring.

pub fn with_busy_line(self, line: u32) -> Wiring

Returns the wiring with an SX126x’s BUSY pin on a line.

Arguments

• line - the line the BUSY pin is on.

Returns

The wiring.

pub fn with_spi_hz(self, hz: u32) -> Wiring

Returns the wiring with another SPI clock.

Arguments

• hz - the clock in hertz.

Returns

The wiring.

Trait Implementations

impl Clone for Wiring

fn clone(&self) -> Wiring

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Wiring

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

Formats the value using the given formatter.

impl Eq for Wiring

impl Hash for Wiring

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Wiring

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Wiring