Module stm32f4xx::clocks::pll::tests

Tests for the PLL clock

This module ensures that the PLL clock works as expected. If changes are brought to the PLL clock, ensure to run all the tests to see if anything is broken.

Usage

First, import the crate::clocks::pll module inside the board main file:

use stm32f429zi::pll;

To run all the available tests, add this line before kernel::process::load_processes():

pll::tests::run(&peripherals.stm32f4.clocks.pll);

If everything works as expected, the following message should be printed on the kernel console:

===============================================
Testing PLL...
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Testing PLL configuration...
Finished testing PLL configuration.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Testing PLL struct...
Finished testing PLL struct.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Finished testing PLL. Everything is alright!
===============================================

There is also the possibility to run a part of the test suite. Check the functions present in this module for more details.

Errors

If there are any errors, open an issue ticket at https://github.com/tock/tock. Please provide the output of the test execution.

Functions

• run
  Run the entire test suite.
• test_pll_config
  Test if the configuration parameters are correctly computed for a given frequency.
• test_pll_struct
  Check if the PLL works as expected.