Pwm upgrades

[RaulTrombin]

Add Logger and Log crates, RUST_LOG=debug ./raspberry-pi

Create a field deticated to navigator's defaults (PWM crystal)

Add new functions and documentation to pwm module:

On some descriptions, the links points to manufacturer's data-sheet and page for further info.

[patrickelectric]

The documentation and updates on the new functions should be on the same commits where there functions were added.

[RaulTrombin]

The documentation and updates on the new functions should be on the same commits where there functions were added.

Ok, squashed the commits

[patrickelectric]

We should not ignore code in the doc files.

[RaulTrombin]

We should not ignore code in the doc files.

They need to run on a armv7-target

**

**

[RaulTrombin]

@patrickelectric

found the '''not_run" resource for rust doc.

Changed last commit.
So CI compile the examples, just not run.
Did a fallback on CI changes.

[patrickelectric]

Suggested change

	//Navigator Defaults
	/// Navigator Defaults

[RaulTrombin]

the idea is to create a header to organize defaults,
constants, adresses and other values.

[RaulTrombin]

@patrickelectric

[patrickelectric]

Yes, I'm suggesting to make generate the documentation for it, implied by ///

[patrickelectric]

Suggested change

	pub fn set_pwm_freq_hz(&mut self, mut freq: f32) {
	if freq < 24.0 {
	warn!("Invalid value. Value must be greater than 24.0.");
	freq = 24.0;
	}
	if freq > 1526.0 {
	warn!("Invalid value. Value must be less than 1526.0.");
	freq = 1526.0;
	}
	let prescale_clamped_value =
	(NAVIGATOR_PWM_XTAL_CLOCK_FREQ / (4_096.0 * freq)).round() as u8 - 1;
	self.set_pwm_freq_prescale(prescale_clamped_value);
	}
	pub fn set_pwm_freq_hz(&mut self, mut freq: f32) {
	let min_freq = 24.0;
	let max_freq = 1526.0;
	if freq < min_freq {
	warn!("Invalid value. Value must be greater than {min_freq}.");
	freq = min_freq;
	}
	if freq > max_freq {
	warn!("Invalid value. Value must be less than {max_freq}.");
	freq = max_freq;
	}
	let prescale_clamped_value =
	(NAVIGATOR_PWM_XTAL_CLOCK_FREQ / (4_096.0 * freq)).round() as u8 - 1;
	self.set_pwm_freq_prescale(prescale_clamped_value);
	}

[joaoantoniocardoso]

should be greater/less than or equal to, not just greater/less than.