#[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,
) -> PamojaStatusExpand 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.