Skip to main content

pamoja_lora_plan_builder_new

pamoja_ffi::lora_region

Function pamoja_lora_plan_builder_new 

Source 
#[unsafe(no_mangle)]
pub unsafe extern "C" fn pamoja_lora_plan_builder_new(
    name: *const c_char,
    out_builder: *mut *mut PamojaLoraPlanBuilder,
) -> PamojaStatus
Expand description

Creates an empty plan builder.

The builder starts with no data rates, channels, or sub-bands, and with a permissive power ceiling; push the tables the deployment uses, then build.

§Arguments

  • name - a null-terminated name for the plan, such as the band it covers.
  • out_builder - set to the builder handle on success, and to null otherwise.

§Returns

PamojaStatus::Ok on success.

§Errors

Returns PamojaStatus::InvalidArgument if either pointer is null or name is not valid UTF-8.

§Safety

name must be a valid null-terminated string and out_builder must point at writable storage for one pointer.