Struct rubble_nrf5x::radio::BleRadio

pub struct BleRadio {
    advertising: bool,
    radio: RADIO,
    tx_buf: &'static mut PacketBuffer,
    rx_buf: Option<&'static mut PacketBuffer>,
}

An interface to the nRF radio in BLE mode.

Fields

advertising: bool

true if the radio is operating on an advertising channel, false if it’s a data channel.

radio: RADIO

tx_buf: &'static mut PacketBuffer

rx_buf: Option<&'static mut PacketBuffer>

Receive buffer.

This is an Option because we need to pass a &mut BleRadio to the BLE stack while still having access to this buffer.

Implementations

impl BleRadio

pub fn new(
    radio: RADIO,
    ficr: &FICR,
    tx_buf: &'static mut PacketBuffer,
    rx_buf: &'static mut PacketBuffer
) -> Self

Initializes the radio in BLE mode and takes ownership of the RX and TX buffers.

pub fn state(&self) -> STATE_R

Returns the current radio state.

pub fn configure_receiver(&mut self, cmd: RadioCmd)

Configures the Radio for (not) receiving data according to cmd.

pub fn recv_interrupt<C: Config<Transmitter = Self>>(
    &mut self,
    timestamp: Instant,
    ll: &mut LinkLayer<C>
) -> Option<Cmd>

Call this when the RADIO interrupt fires.

Automatically reconfigures the radio according to the RadioCmd returned by the BLE stack.

Returns when the update method should be called the next time.

fn prepare_txrx_advertising(&mut self, channel: AdvertisingChannel)

Perform preparations to receive or send on an advertising channel.

This will disable the radio, configure the packet layout, set initial values for CRC and whitening, and set the frequency to the given channel.

To transmit, the txaddress must be set and the packetptr must be set to the TX buffer.

To receive, the rxaddresses must be set to receive on logical address 0 and packetptr must be pointed to the RX buffer.

Of course, other tasks may also be performed.

fn prepare_txrx_data(
    &mut self,
    channel: DataChannel,
    access_address: u32,
    crc_init: u32
)

fn transmit(&mut self)

Transmit a PDU from the internal buffer.

This will block until the transmission has completed.

Assumes that all registers are correct for this type of transmission.

Trait Implementations

impl Transmitter for BleRadio

fn tx_payload_buf(&mut self) -> &mut [u8]

Get a reference to the Transmitter’s PDU payload buffer.

fn transmit_advertising(&mut self, header: Header, channel: AdvertisingChannel)

Transmit an Advertising Channel PDU.

fn transmit_data(
    &mut self,
    _access_address: u32,
    _crc_iv: u32,
    header: Header,
    _channel: DataChannel
)

Transmit a Data Channel PDU.