Merge pull request #22295 from basilfx/feature/efm32_fix_hfxo_clock

boards/xg23-pk6068a: remove HFXO_FREQ and LFXO_FREQ

Author: basilfx

boards/xg23-pk6068a/doc.md

@@ -98,6 +98,23 @@ PIN 1 is the bottom-left contact when the header faces  you horizontally.
 | LCD driver                    | LS013B7DH03 | yes       | Sharp Low Power Memory LCD via the U8g2 package                |
 | Temperature + humidity sensor | Si7021      | yes       | Silicon Labs Temperature + Humidity sensor                     |
 
+## Board configuration
+
+### Clock selection
+There are several clock sources that are available for the different
+peripherals. You are advised to read [AN0004.0](https://www.silabs.com/documents/public/application-notes/an0004.0-efm32-cmu.pdf)
+to get familiar with the different clocks.
+
+| Source | Internal | Speed      | Comments                           |
+|--------|----------|------------|------------------------------------|
+| HFXO   | No       | 39 MHz     |                                    |
+| LFXO   | No       | 32.768 kHz |                                    |
+
+It is important that the clock speeds are known to the code, for proper
+calculations of speeds and baud rates. If the HFXO or LFXO are different from
+the speeds above, ensure to pass `HFXO_FREQ=freq_in_hz` and
+`LFXO_FREQ=freq_in_hz` to your compiler defines.
+
 ## Flashing the device
 
 To flash, [SEGGER JLink](https://www.segger.com/jlink-software.html) is

boards/xg23-pk6068a/include/board.h

@@ -36,7 +36,7 @@ extern "C" {
  * @{
  */
 #define CONFIG_ZTIMER_LPTIMER_DEV            TIMER_DEV(1)
-#define CONFIG_ZTIMER_LPTIMER_FREQ           LFXO_FREQ
+#define CONFIG_ZTIMER_LPTIMER_FREQ           (32768UL)
 #define CONFIG_ZTIMER_LPTIMER_WIDTH          24
 #define CONFIG_ZTIMER_LPTIMER_BLOCK_PM_MODE  EFM32_PM_MODE_EM3
 /** @} */

boards/xg23-pk6068a/include/periph_conf.h

@@ -28,10 +28,7 @@ extern "C" {
  * @name    Clock configuration
  * @{
  */
-#define HFXO_FREQ           (39000000UL)
 #define CMU_HFXOINIT        CMU_HFXOINIT_DEFAULT
-
-#define LFXO_FREQ           (32768UL)
 #define CMU_LFXOINIT        CMU_LFXOINIT_DEFAULT
 
 static const clk_mux_t clk_mux_config[] = {

dist/tools/doccheck/exclude_simple

@@ -2597,7 +2597,6 @@ warning: Member HDC1000_TRES_MSK (macro definition) of file hdc1000_regs.h is no
 warning: Member HDC1010_PARAM_ADDR (macro definition) of file board.h is not documented.
 warning: Member HDC1010_PARAM_I2C (macro definition) of file board.h is not documented.
 warning: Member HDC1010_PIN_DRDY (macro definition) of file board.h is not documented.
-warning: Member HFXO_FREQ (macro definition) of file periph_conf.h is not documented.
 warning: Member HMC5883L_PARAM_DEV (macro definition) of file hmc5883l_params.h is not documented.
 warning: Member HMC5883L_PARAM_DOR (macro definition) of file hmc5883l_params.h is not documented.
 warning: Member HMC5883L_PARAM_GAIN (macro definition) of file hmc5883l_params.h is not documented.
@@ -3084,7 +3083,6 @@ warning: Member LED_RED_OFF (macro definition) of file board.h is not documented
 warning: Member LED_RED_ON (macro definition) of file board.h is not documented.
 warning: Member LED_RED_PIN (macro definition) of file board.h is not documented.
 warning: Member LED_RED_TOGGLE (macro definition) of file board.h is not documented.
-warning: Member LFXO_FREQ (macro definition) of file periph_conf.h is not documented.
 warning: Member LINEFILL (macro definition) of file ColorTextColors.h is not documented.
 warning: Member LIS2DH12_CLICK_THS_LIR (macro definition) of file lis2dh12_registers.h is not documented.
 warning: Member LIS2DH12_CTRL_REG2_FDS (macro definition) of file lis2dh12_registers.h is not documented.