User Switch

Lab 2: User Switch — อ่านปุ่มกด & Debounce

วัตถุประสงค์

• GPIO Input: อ่านค่าจาก Digital Input

• Debounce: ป้องกันการอ่านค่าผิดพลาดจาก Contact Bounce

• State Machine: เปลี่ยน LED state เมื่อกดปุ่ม

จะได้เรียนรู้อะไร?

• GPIO Read: Cy_GPIO_Read()

• Active LOW: ปุ่มกดลง = 0

• Debounce Pattern: Software debounce

• Static Variables: เก็บ state ระหว่าง function calls

Hardware Information

Component	Port/Pin	หมายเหตุ
User LED1	CYBSP_USER_LED1	Active HIGH (HIGH = ON)
User Button 1 (SW2)	CYBSP_USER_BTN1	Active LOW (กดลง = 0)
User Button 2 (SW4)	CYBSP_USER_BTN2	Active LOW (กดลง = 0)

---

Lab 2.1 : อ่านปุ่มกดแบบ Polling

เพิ่ม Button Macros:

/* เพิ่มหลัง LED macros */

/* Button Configuration */
#define USER_BTN_PORT       CYBSP_USER_BTN1_PORT
#define USER_BTN_PIN        CYBSP_USER_BTN1_PIN

/* Button Read Macro - Active LOW */
#define IS_BUTTON_PRESSED() (Cy_GPIO_Read(USER_BTN_PORT, USER_BTN_PIN) == 0)

แก้ไขฟังก์ชั่น Main :

int main(void)
{
    cy_rslt_t result = CY_RSLT_SUCCESS;
    
    /* Initialize */
    result = cybsp_init();
    if (CY_RSLT_SUCCESS != result) { handle_app_error(); }

    __enable_irq();
    init_retarget_io();

    printf("\x1b[2J\x1b[;H");
    printf("*** PSoC Edge: Button Demo ***\r\n");
    printf("Press SW2 to toggle LED\r\n\n");

    Cy_SysEnableCM55(MXCM55, CM55_APP_BOOT_ADDR, CM55_BOOT_WAIT_TIME_USEC);

    /* Main loop */
    for(;;)
    {
        /* ตรวจสอบปุ่ม */
        if (IS_BUTTON_PRESSED())
        {
            printf("Button pressed!\r\n");
        } else
        {
            printf("Button NOT pressed!\r\n");
        }

        /* หน่วงเวลาเล็กน้อยเพื่อลด CPU load */
        Cy_SysLib_Delay(10);
    }
}

---

Lab 2.2 : Debounce แบบง่าย (Edge Detection)

WHY: ทำไมต้องรู้?

• ปัญหา: ปุ่มกดมีสัญญาณกระเด้ง (bouncing) ทำให้ detect หลายครั้ง (5-10 ครั้ง!)

• ประโยชน์: อ่านค่าปุ่มได้ถูกต้อง, ไม่มี false triggers

• Hardware: Mechanical switch มี contact bounce 10-50ms

ปุ่มกดจริงๆ:     ___████████████___
                 ↑ กด        ↑ ปล่อย

สัญญาณที่ MCU เห็น: ___█_█_██_█████___
                    ↑ Bouncing!

CAUTION: ข้อควรระวัง

ข้อผิดพลาด	ผลกระทบ	วิธีป้องกัน
Delay สั้นเกินไป	ยัง bounce อยู่	ใช้ 20-50ms
Delay นานเกินไป	ผู้ใช้รู้สึกว่า laggy	ไม่ควรเกิน 100ms
Debounce ใน ISR	Block interrupt นาน	ใช้ timer-based debounce

เพิ่ม Button Macros

/* เพิ่มหลัง LED macros */

/* Button Configuration */
#define USER_BTN_PORT       CYBSP_USER_BTN1_PORT
#define USER_BTN_PIN        CYBSP_USER_BTN1_PIN
#define DEBOUNCE_DELAY_MS   (50U)

/* Button Read Macro - Active LOW */
#define IS_BUTTON_PRESSED() (Cy_GPIO_Read(USER_BTN_PORT, USER_BTN_PIN) == 0)

สร้างฟังก์ชัน Debounce

/*******************************************************************************
* Function Name: read_button_with_debounce
********************************************************************************
* Summary:
*   อ่านค่าปุ่มพร้อม debounce เพื่อป้องกันการ bounce
*
* Parameters:
*   None
*
* Return:
*   true ถ้าปุ่มถูกกด (และ debounced แล้ว), false ถ้าไม่ได้กด
*
* Note:
*   ใช้ static variables เพื่อเก็บ state ระหว่าง calls
*******************************************************************************/
bool read_button_with_debounce(void)
{
    static bool last_state = false;
    static uint32_t last_press_time = 0;

    bool current_state = IS_BUTTON_PRESSED();
    uint32_t current_time = Cy_SysLib_GetTimerTick();

    /* ถ้าสถานะเปลี่ยนจาก not-pressed → pressed */
    if (current_state && !last_state)
    {
        /* ตรวจสอบว่าผ่าน debounce time แล้ว */
        if ((current_time - last_press_time) > DEBOUNCE_DELAY_MS)
        {
            last_state = current_state;
            last_press_time = current_time;
            return true;  /* Button pressed! */
        }
    }

    last_state = current_state;
    return false;
}

แก้ไข Main Loop

int main(void)
{
    cy_rslt_t result = CY_RSLT_SUCCESS;

    /* Initialize */
    result = cybsp_init();
    if (CY_RSLT_SUCCESS != result) { handle_app_error(); }

    __enable_irq();
    init_retarget_io();

    printf("\x1b[2J\x1b[;H");
    printf("*** PSoC Edge: Button Demo ***\r\n");
    printf("Press SW2 to toggle LED\r\n\n");

    Cy_SysEnableCM55(MXCM55, CM55_APP_BOOT_ADDR, CM55_BOOT_WAIT_TIME_USEC);

    /* Main loop */
    for(;;)
    {
        /* ตรวจสอบปุ่ม */
        if (read_button_with_debounce())
        {
            LED_TOGGLE();
            printf("Button pressed! LED toggled.\r\n");
        }

        /* หน่วงเวลาเล็กน้อยเพื่อลด CPU load */
        Cy_SysLib_Delay(10);
    }
}

Debounce Flowchart

┌─────────────────────────────────────────────────────────────────┐
│                     Debounce Algorithm                          │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│   ┌──────────────────┐                                          │
│   │  Read Button     │                                          │
│   │  (current_state) │                                          │
│   └────────┬─────────┘                                          │
│            │                                                    │
│            ▼                                                    │
│   ┌──────────────────────────────┐                              │
│   │ current == true              │                              │
│   │ last_state == false          │─── NO ──► return false       │
│   │ (Rising edge detected?)      │                              │
│   └────────┬─────────────────────┘                              │
│            │ YES                                                │
│            ▼                                                    │
│   ┌──────────────────────────────┐                              │
│   │ time - last_time > 50ms      │                              │
│   │ (Debounce period passed?)    │─── NO ──► return false       │
│   └────────┬─────────────────────┘                              │
│            │ YES                                                │
│            ▼                                                    │
│   ┌──────────────────┐                                          │
│   │  Update state    │                                          │
│   │  return true     │ ◄── Valid button press!                  │
│   └──────────────────┘                                          │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

---

ทำความเข้าใจการเรียกใช้ Static Variables

/* static ภายใน function = เก็บค่าระหว่าง calls */

void example(void)
{
    static int count = 0;  /* Initialize ครั้งเดียวตอนเริ่มโปรแกรม */
    count++;
    printf("Called %d times\n", count);
}

/* เรียก example() 3 ครั้ง:
 * Called 1 times
 * Called 2 times
 * Called 3 times
 */

/* ถ้าไม่ใช้ static: */
void bad_example(void)
{
    int count = 0;  /* Initialize ทุกครั้งที่เรียก! */
    count++;
    printf("Called %d times\n", count);
}

/* เรียก bad_example() 3 ครั้ง:
 * Called 1 times
 * Called 1 times
 * Called 1 times
 */

✍️ Exercise

1. Press Counter : นับจำนวนครั้งที่กดปุ่มและแสดงผล

1. Long Press Detection : ตรวจจับการกดค้าง (> 1 วินาที) และทำ action แตกต่าง

---