Skip to main content

pamoja_lorawan_relay_personalized

Function pamoja_lorawan_relay_personalized 

Source
#[unsafe(no_mangle)]
pub unsafe extern "C" fn pamoja_lorawan_relay_personalized( plan: *const PamojaLoraPlan, session: *const PamojaLorawanSession, settings: *const PamojaLorawanDeviceSettings, xtal_accuracy: u8, cad_to_rx: u8, out_relay: *mut *mut PamojaLorawanRelay, ) -> PamojaStatus
Expand description

Makes a relay whose own device is activated by personalization.

§Arguments

  • plan - a published channel plan.
  • session - the relay’s own address and session keys.
  • settings - what its radio can do.
  • xtal_accuracy - how accurate the relay’s crystal is, as TS011-1.0.1 table 17 codes it.
  • cad_to_rx - how many symbols it takes from detecting a preamble to receiving, as table 15 codes it.
  • out_relay - receives the relay.

§Returns

PamojaStatus::Ok on success.

§Errors

Returns PamojaStatus::InvalidArgument for a null pointer, a plan that is not a published one, or settings out of range.

§Safety

plan and session must be live handles, settings must point to a readable PamojaLorawanDeviceSettings, and out_relay to a writable pointer.