Hackster will be offline on Monday, June 15 from 5pm to 7pm PDT to perform some scheduled maintenance.

Prelim Exam (Project-based) Human Response Timer

A simple STM32 project that creates sounds and lets users adjust the pitch using buttons controls.

IntermediateProtip1.5 hours16
Prelim Exam (Project-based) Human Response Timer

Things used in this project

Hardware components

Breadboard (generic)
Breadboard (generic)
×1
Jumper wires (generic)
Jumper wires (generic)
×4
Buzzer
Buzzer
×1
Resistor 220 ohm
Resistor 220 ohm
×1
RT Thread Spark Development Board
×1
Digital Oscilloscope
×1

Software apps and online services

STM32 CubeMX
STM32 CubeIDE

Story

Read more

Custom parts and enclosures

Github Repository

Schematics

Pins Schematic Diagram

Code

main.c

C/C++
/* USER CODE BEGIN Header */
/**
  ****************************************************************************
  * @file           : main.c
  * @brief          : Main program body
  ****************************************************************************
  * @attention
  *
  * Copyright (c) 2026 STMicroelectronics.
  * All rights reserved.
  *
  * This software is licensed under terms that can be found in the LICENSE file
  * in the root directory of this software component.
  * If no LICENSE file comes with this software, it is provided AS-IS.
  *
  ****************************************************************************
  */
/* USER CODE END Header */
/* Includes ------------------------------------------------------------------*/
#include "main.h"

/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */
#include "delay.h"
/* USER CODE END Includes */

/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PTD */

/* USER CODE END PTD */

/* Private define ------------------------------------------------------------*/
/* USER CODE BEGIN PD */

/* USER CODE END PD */

/* Private macro -------------------------------------------------------------*/
/* USER CODE BEGIN PM */

/* USER CODE END PM */

/* Private variables ---------------------------------------------------------*/

/* USER CODE BEGIN PV */
volatile uint32_t current_Period_us = 1250; // current Frequency = 10kHz
const uint32_t min_Period_us = 100; // 10kHz
const uint32_t max_Period_us = 10000; // 100 Hz
const uint32_t step_Size_us = 100;

uint8_t switch1_state = 0;
uint8_t switch3_state = 0;
/* USER CODE END PV */

/* Private function prototypes -----------------------------------------------*/
void SystemClock_Config(void);
static void MX_GPIO_Init(void);
/* USER CODE BEGIN PFP */

/* USER CODE END PFP */

/* Private user code ---------------------------------------------------------*/
/* USER CODE BEGIN 0 */

// THE BUILT-IN LEDs ARE ACTIVE-LOW OR HIGH = OFF, LOW = ON
void play_tone(unsigned int duration_ms) {
    uint32_t total_duration_us = duration_ms * 1000;
    uint32_t elapsed_us = 0;

    // Loop until the requested duration has passed
    while(elapsed_us < total_duration_us) {
        // Toggle Pin High
        HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_SET);
        udelay(current_Period_us / 2);

        HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_RESET);
        udelay(current_Period_us / 2);

        // Accumulate the time spent in one full cycle
        elapsed_us += current_Period_us;
    }
}

// GPIOC-Pin0/4/5 = Set as Pull-Up
void update_buttons() {
    uint8_t switch1 = HAL_GPIO_ReadPin(GPIOC, GPIO_PIN_0); //BUTTON LEFT
    uint8_t switch2 = HAL_GPIO_ReadPin(GPIOC, GPIO_PIN_5); //BUTTON UP
    uint8_t switch3 = HAL_GPIO_ReadPin(GPIOC, GPIO_PIN_4); //BUTTON RIGHT

    // BUTTON LEFT/SWITCH1 CHECK IF PRESSED
    if(switch1 == GPIO_PIN_RESET && switch1_state == 0) {
        if(min_Period_us < current_Period_us) {
            current_Period_us = current_Period_us - step_Size_us;
        }

        switch1_state = 1;
    }

    // BUTTON LEFT/SWITCH1 CHECK IF NOT PRESSED
    if(switch1 == GPIO_PIN_SET && switch1_state == 1) {
        switch1_state = 0;
    }

    //BUTTON RIGHT/SWITCH3 CHECK IF PRESSED
    if(switch3 == GPIO_PIN_RESET && switch3_state == 0) {
        if(current_Period_us < max_Period_us) {
            current_Period_us = current_Period_us + step_Size_us;
        }

        switch3_state = 1;
    }

    // BUTTON RIGHT/SWITCH3 CHECK IF NOT PRESSED
    if(switch3 == GPIO_PIN_SET && switch3_state == 1) {
        switch3_state = 0;
    }

    // BUTTON UP/SWITCH2 CHECK IF PRESSED
    if(switch2 == GPIO_PIN_RESET) {
        play_tone(100);
    }
}

/* USER CODE END 0 */

/**
  * @brief  The application entry point.
  * @retval int
  */
int main(void)
{

  /* USER CODE BEGIN 1 */

  /* USER CODE END 1 */

  /* MCU Configuration--------------------------------------------------------*/

  /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
  HAL_Init();

  /* USER CODE BEGIN Init */

  /* USER CODE END Init */

  /* Configure the system clock */
  SystemClock_Config();

  /* USER CODE BEGIN SysInit */

  /* USER CODE END SysInit */

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  /* USER CODE BEGIN 2 */

  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
      update_buttons();
  }
  /* USER CODE END 3 */
}

/**
  * @brief System Clock Configuration
  * @retval None
  */
void SystemClock_Config(void)
{
  RCC_OscInitTypeDef RCC_OscInitStruct = {0};
  RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};

  /** Configure the main internal regulator output voltage
  */
  __HAL_RCC_PWR_CLK_ENABLE();
  __HAL_PWR_VOLTAGESCALING_CONFIG(PWR_REGULATOR_VOLTAGE_SCALE1);

  /** Initializes the RCC Oscillators according to the specified parameters
  * in the RCC_OscInitTypeDef structure.
  */
  RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSI;
  RCC_OscInitStruct.HSIState = RCC_HSI_ON;
  RCC_OscInitStruct.HSICalibrationValue = RCC_HSICALIBRATION_DEFAULT;
  RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE;
  if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
  {
    Error_Handler();
  }

  /** Initializes the CPU, AHB and APB buses clocks
  */
  RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
                              |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
  RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_HSI;
  RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
  RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV1;
  RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;

  if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_0) != HAL_OK)
  {
    Error_Handler();
  }
}

/**
  * @brief GPIO Initialization Function
  * @param None
  * @retval None
  */
static void MX_GPIO_Init(void)
{
  GPIO_InitTypeDef GPIO_InitStruct = {0};
  /* USER CODE BEGIN MX_GPIO_Init_1 */

  /* USER CODE END MX_GPIO_Init_1 */

  /* GPIO Ports Clock Enable */
  __HAL_RCC_GPIOC_CLK_ENABLE();
  __HAL_RCC_GPIOA_CLK_ENABLE();

  /*Configure GPIO pin Output Level */
  HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_RESET);

  /*Configure GPIO pins : PC0 PC4 PC5 */
  GPIO_InitStruct.Pin = GPIO_PIN_0|GPIO_PIN_4|GPIO_PIN_5;
  GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
  GPIO_InitStruct.Pull = GPIO_PULLUP;
  HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);

  /*Configure GPIO pin : PA2 */
  GPIO_InitStruct.Pin = GPIO_PIN_2;
  GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
  GPIO_InitStruct.Pull = GPIO_NOPULL;
  GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
  HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

  /* USER CODE BEGIN MX_GPIO_Init_2 */

  /* USER CODE END MX_GPIO_Init_2 */
}

/* USER CODE BEGIN 4 */

/* USER CODE END 4 */

/**
  * @brief  This function is executed in case of error occurrence.
  * @retval None
  */
void Error_Handler(void)
{
  /* USER CODE BEGIN Error_Handler_Debug */
  /* User can add his own implementation to report the HAL error return state */
  __disable_irq();
  while (1)
  {
  }
  /* USER CODE END Error_Handler_Debug */
}

#ifdef USE_FULL_ASSERT
/**
  * @brief  Reports the name of the source file and the source line number
  *         where the assert_param error has occurred.
  * @param  file: pointer to the source file name
  * @param  line: assert_param error line source number
  * @retval None
  */
void assert_failed(uint8_t *file, uint32_t line)
{
  /* USER CODE BEGIN 6 */
  /* User can add his own implementation to report the file name and line number,
     ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
  /* USER CODE END 6 */
}
#endif /* USE_FULL_ASSERT */

Credits

Rebecca Lyn ANTONIO
4 projects • 0 followers
Candice S. Guinoo
3 projects • 0 followers
Paul Rodolf P. Castor
29 projects • 9 followers

Comments