tests/periph/selftest_shield: improve SPI test

- fix a copy-paste error (`TIMER_FREQ_UART_TEST` was used in the SPI
  test, but that should be `TIMER_FREQ_SPI_TEST`)
- use 400 kHz as slow SPI frequency, as faster STM32 MCUs just cannot
  divide the APB clock down to 100 kHz
- when detailed output is enabled, print the SPI clock in addition to
  the SPI mode to ease figuring out what went wrong
- only have one `FAILURE` message for a too fast byte transfer per
  check, rather than per transmitted byte, to reduce the noise
- work around a bug of `periph_timer` on STM32 by reducing the clock
  speed of the timer for the SPI test

tests/periph/selftest_shield/main.c

@@ -19,6 +19,7 @@
  * @}
  */
 
+#include <inttypes.h>
 #include <stdbool.h>
 #include <stdint.h>
 #include <stdatomic.h>
@@ -137,7 +138,7 @@
  * directly, so the CPU clock is the highest clock frequency available. But
  * some can't, so we handle them here explicitly. */
 #ifndef TIMER_FREQ_SPI_TEST
-# if defined(CPU_SAM3)
+# if defined(CPU_SAM3) || defined(CPU_STM32)
 # define TIMER_FREQ_SPI_TEST CLOCK_CORECLOCK / 4
 # elif defined(CPU_NRF52) || defined(CPU_NRF51)
 # define TIMER_FREQ_SPI_TEST MHZ(16)
@@ -784,13 +785,14 @@ static bool periph_spi_rxtx_test(spi_t bus, spi_mode_t mode, spi_clk_t clk,
  const char *test_in_detail)
 {
  (void)test_in_detail;
- bool failed = 0;
+ bool failed = false;
+ bool transfer_too_fast = false;
  print_start("SPI", test_in_detail);
  uint16_t byte_transfer_ticks = 0;
  memset(&serial_buf, 0, sizeof(serial_buf));
 
  if (IS_USED(MODULE_PERIPH_TIMER)) {
- byte_transfer_ticks = 8ULL * TIMER_FREQ_UART_TEST / clk_hz;
+ byte_transfer_ticks = 8ULL * TIMER_FREQ_SPI_TEST / clk_hz;
  }
 
  /* D10 is C̅S̅, D7 is connected to C̅S̅ */
@@ -808,6 +810,7 @@ static bool periph_spi_rxtx_test(spi_t bus, spi_mode_t mode, spi_clk_t clk,
  /* C̅S̅ should still be HIGH while no chip is selected */
  failed |= TEST(gpio_read(cs_check) != 0);
 
+ uint16_t byte_time;
  for (uint8_t i = 0; i < UINT8_MAX; i++) {
  uint16_t start = 0;
  if (IS_USED(MODULE_PERIPH_TIMER)) {
@@ -819,15 +822,25 @@ static bool periph_spi_rxtx_test(spi_t bus, spi_mode_t mode, spi_clk_t clk,
  stop = timer_read(TIMER);
  }
  failed |= TEST(received == i);
- uint16_t byte_time = (uint16_t)(stop - start);
- /* We allow the actual SPI clock to be slower than requested, but not
- * faster. So the transfer needs to take *at least* the theoretical
- * time. Given the overhead of, this already has some room for error */
- failed |= TEST(byte_time >= byte_transfer_ticks);
- /* C̅S̅ should be still LOW while chip is selected */
+ if (IS_USED(MODULE_PERIPH_TIMER)) {
+ byte_time = (uint16_t)(stop - start);
+ /* We allow the actual SPI clock to be slower than requested, but
+ * not faster. So the transfer needs to take *at least* the
+ * theoretical time. Given the overhead of, this already has some
+ * room for error */
+ transfer_too_fast |= (byte_time < byte_transfer_ticks);
+ /* C̅S̅ should be still LOW while chip is selected */
+ }
  failed |= TEST(gpio_read(cs_check) == 0);
  }
 
+ if (DETAILED_OUTPUT && transfer_too_fast) {
+ printf("Ticks expected to transfer byte: >= %" PRIu16 ", but got: %"
+ PRIu16 "\n",
+ byte_transfer_ticks, byte_time);
+ }
+
+ failed |= TEST(!transfer_too_fast);
  failed |= TEST(spi_transfer_byte(bus, cs, false, UINT8_MAX) == UINT8_MAX);
  /* C̅S̅ should be again HIGH while now that no chip is selected */
  failed |= TEST(gpio_read(cs_check) != 0);
@@ -871,8 +884,8 @@ static bool periph_spi_test(void)
  }
 
  bool failed = false;
- static const spi_clk_t clocks[] = { SPI_CLK_100KHZ, SPI_CLK_1MHZ, SPI_CLK_10MHZ };
- static const uint32_t clk_hzs[] = { KHZ(100), MHZ(1), MHZ(10) };
+ static const spi_clk_t clocks[] = { SPI_CLK_400KHZ, SPI_CLK_1MHZ, SPI_CLK_10MHZ };
+ static const uint32_t clk_hzs[] = { KHZ(400), MHZ(1), MHZ(10) };
 
  if (IS_USED(MODULE_PCF857X)) {
  for (int i = 0; i < (int)ARRAY_SIZE(spi_clk_check_pins); i++) {
@@ -888,6 +901,9 @@ static bool periph_spi_test(void)
  for (unsigned j = 0; j < ARRAY_SIZE(clocks); j++) {
  spi_clk_t clk = clocks[j];
  uint32_t clk_hz = clk_hzs[j];
+ if (DETAILED_OUTPUT) {
+ printf("SPI CLK %" PRIu32 " Hz\n", clk_hz);
+ }
  failed |= periph_spi_rxtx_test(bus, SPI_MODE_0, clk, clk_hz, clk_check, false, "mode 0");
  failed |= periph_spi_rxtx_test(bus, SPI_MODE_1, clk, clk_hz, clk_check, false, "mode 1");
  failed |= periph_spi_rxtx_test(bus, SPI_MODE_2, clk, clk_hz, clk_check, true, "mode 2");