Struct JoinRequest 

pub struct JoinRequest { /* private fields */ }

A join-request a device broadcast, with its integrity already verified.

parse checks the request against the application root key before reporting anything, so the identifiers it hands back are the ones the key holder actually sent rather than whatever arrived on the air.

Examples

use pamoja_lorawan::{Device, JoinRequest};

const APP_KEY: [u8; 16] = [0xAB; 16];
let device = Device::new([0x11; 8], [0x22; 8], APP_KEY);
let on_air = device.join_request(0x1234);

// The network recognises the device and the nonce it must not accept twice.
let request = JoinRequest::parse(on_air.as_bytes(), &APP_KEY)?;
assert_eq!(request.dev_eui(), [0x11; 8]);
assert_eq!(request.dev_nonce(), 0x1234);

Implementations

impl JoinRequest

pub fn parse( bytes: &[u8], app_key: &[u8; 16], ) -> Result<JoinRequest, LorawanError>

Verifies a join-request and reads the identifiers out of it.

Arguments

• bytes - the raw join-request as it came off the radio.
• app_key - the application root key the device shares with this network.

Returns

The verified request.

Errors

Returns LorawanError::FrameTooShort if the frame is empty, LorawanError::UnsupportedMType if it is not a join-request, LorawanError::MalformedFrame if it is not the fixed 23 bytes a join-request is, or LorawanError::MicMismatch if its MIC does not verify, which means it was not sent by a holder of app_key.

pub fn dev_eui(&self) -> [u8; 8]

Returns the device identifier, most-significant byte first.

Returns

The DevEUI, as it is written rather than as it was transmitted.

pub fn app_eui(&self) -> [u8; 8]

Returns the application identifier, most-significant byte first.

Returns

The AppEUI, as it is written rather than as it was transmitted.

pub fn dev_nonce(&self) -> u16

Returns the nonce this request carried.

A network must remember the nonces a device has already used and refuse a repeat, since replaying one would re-derive the same session keys.

Returns

The DevNonce.

Trait Implementations

impl Clone for JoinRequest

fn clone(&self) -> JoinRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for JoinRequest

impl Debug for JoinRequest

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

Formats the value using the given formatter.

impl Eq for JoinRequest

impl PartialEq for JoinRequest

fn eq(&self, other: &JoinRequest) -> 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 JoinRequest