Skip to main content

TxPower

Struct TxPower 

Source
pub struct TxPower {
    pub pa: PaConfig,
    pub setting_dbm: i8,
}
Expand description

The amplifier configuration and power setting that produce an output power.

§Examples

use pamoja_lora::budget::{Decibels, LinkBudget};
use pamoja_radios::sx126x::config::{PaConfig, PowerAmplifier, TxPower};

// A 2.15 dBi whip on half a decibel of pigtail under a 16 dBm EIRP ceiling.
let whip = LinkBudget {
    transmit_antenna_gain_dbi: Decibels::from_hundredths(215),
    transmit_cable_loss_db: Decibels::from_tenths(5),
    ..LinkBudget::default()
};
let power = TxPower::under_ceiling(PowerAmplifier::HighPower, &whip, Decibels::from_db(16));
assert_eq!(power.setting_dbm, 14);
assert_eq!(power.pa, PaConfig::SX1262_22_DBM);

Fields§

§pa: PaConfig

The SetPaConfig parameters.

§setting_dbm: i8

The power byte of SetTxParams, in dBm.

Implementations§

Source§

impl TxPower

Source

pub const fn for_output(amplifier: PowerAmplifier, output_dbm: i8) -> TxPower

Chooses the settings for an output power.

The high power amplifier keeps its +22 dBm configuration and takes the power in SetTxParams, clamped to -9 to +22 dBm. The low power amplifier uses its +14 dBm configuration with the power clamped to -17 to +14 dBm, and its +15 dBm configuration, which Table 13-21 drives with a setting of +14 dBm, for anything above.

§Arguments
  • amplifier - the chip’s power amplifier.
  • output_dbm - the output power wanted at the antenna port.
§Returns

The configuration and the setting.

Source

pub fn under_ceiling( amplifier: PowerAmplifier, budget: &LinkBudget, eirp_ceiling_dbm: Decibels, ) -> TxPower

Chooses the settings that keep a link’s EIRP at or under a ceiling.

§Arguments
  • amplifier - the chip’s power amplifier.
  • budget - the link budget, whose transmitting antenna and cable apply.
  • eirp_ceiling_dbm - the EIRP limit, such as a channel plan’s ceiling for the frequency in use.
§Returns

The configuration and the setting, rounded down to whole decibels so the EIRP stays under the ceiling.

Trait Implementations§

Source§

impl Clone for TxPower

Source§

fn clone(&self) -> TxPower

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for TxPower

Source§

impl Debug for TxPower

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for TxPower

Source§

impl Hash for TxPower

Source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
Source§

impl PartialEq for TxPower

Source§

fn eq(&self, other: &TxPower) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl StructuralPartialEq for TxPower

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.