* @brief Attach the button event callback function * @param handle: the button handle struct * @param event: trigger event type * @param cb:

---- Helper: advance N ticks ---- */

* @brief Start the button work, add the handle into work list * @param handle: target handle struct * @retval 0: succeed, -1: already exist, -2:

* @brief Get the repeat count of button presses * @param handle: the button handle struct * @retval repeat count */

* @brief Initialize the button struct handle * @param handle: the button handle struct * @param pin_level: read the HAL GPIO of the connected b

Simulate button press

* @brief Stop the button work, remove the handle from work list * @param handle: target handle struct * @retval None */

* @brief Check if button is currently pressed * @param handle: the button handle struct * @retval 1: pressed, 0: not pressed, -1: error */

* @brief Background ticks, timer repeat invoking interval 5ms * Callbacks are executed outside the lock so they may safely * call

Generic event handler that shows button info

* @brief Get the button event that happened * @param handle: the button handle struct * @retval button event */

Simulate button press for demonstration

* @brief Detach the button event callback function * @param handle: the button handle struct * @param event: trigger event type * @retval Non

* @brief Reset button state to idle * @param handle: the button handle struct * @retval None */

Initialize a single button with all event handlers

* @brief Button driver core function, driver state machine * @param handle: the button handle struct * @retval None */

Initialize button without callbacks (polling mode)

* @brief Read button level with inline optimization * @param handle: the button handle struct * @retval button level */

Initialize all buttons

Initialize buttons

Dynamic configuration demo

Poll button events and handle them

Print button status

Print periodic status

Interactive demo sequence

Callback functions for button 1

Callback functions for button 2

Main function

Main function

Main function

Special handler for button configuration

Event handlers

Hardware abstraction layer function

Hardware abstraction layer function This simulates reading GPIO states

Hardware abstraction layer function

Signal handler for graceful exit

Signal handler for graceful exit

Signal handler for graceful exit

Test 5: Debounce rejects noise */

Test 15: Boundary - DEBOUNCE_TICKS edge behavior */

Test 2: Double click */

Test 3: Long press */

Test 9: NULL handle safety */

Test 16: Stress test - rapid alternating press/release */

Test 4: Repeat press count */

Test 6: REPEAT->PRESS transition resets ticks (bug fix verification) */

Test 10: button_reset clears state properly */

Test 1: Single click */

Test 7: button_start duplicate returns -1 */

Test 8: button_stop then restart works cleanly */

Test 12: ticks counter saturation (no overflow) */

Test 13: Triple click via repeat count */