เป้าหมาย

เมื่อจบบทเรียนนี้ คุณจะ

1. อ่านค่าความดันบรรยากาศและอุณหภูมิจาก DPS368 ผ่าน I2C แล้วแสดงบนจอ
2. อธิบายการแบ่งชั้น driver → reader → presenter → view ของ episode
3. ตรวจค่าที่อ่านได้กับค่าความดันอ้างอิงของพื้นที่ และอธิบายส่วนต่าง

ก่อนเริ่ม

• ผ่านบทเรียนก่อนหน้ามาแล้ว: fw-stack.m02.l07
• บอร์ด: TESAIoT Dev Kit
• แพลตฟอร์ม: PSoC Edge E84 · ModusToolbox
• เวลาโดยประมาณ: เนื้อหา 15 + ฝึกตาม 25 + แล็บ 20 + เช็กความเข้าใจ 5 = 65 นาที

ดูของจริงก่อน

ก่อนอ่านโค้ด ให้ทายว่าหน้าจอนี้มี object อะไรบ้าง และอะไรเปลี่ยนเมื่อผู้ใช้แตะหรือเมื่อค่าเซนเซอร์เปลี่ยน

แนวคิด — DPS368 คืออะไร

Barometer แบบ capacitive MEMS ของ Infineon — วัดความดัน 300–1200 hPa ที่ความละเอียด ±0.002 hPa (≈ 2 ซม. ความสูง)

วัดอุณหภูมิร่วมด้วยเพื่อชดเชยค่าความดัน — สูตรชดเชยอยู่ในไลบรารี Infineon แล้ว

แนวคิด — สี่ชั้นของโค้ด

dps368_driver (คุย xensiv_dps3xx โดยตรง) → dps368_reader (ห่อเป็น poll() เดียว) → dps368_presenter (ผูก timer) → dps368_view (label ล้วน ๆ ไม่มี gauge)

แต่ละชั้นรู้จักแค่ชั้นติดกัน — view ไม่รู้จัก I2C, driver ไม่รู้จัก LVGL

แนวคิด — I2C bus พร้อมใช้ + address fallback

main_example.c ส่ง &sensor_i2c_controller_hal_obj ที่ master เปิดไว้แล้วตรงเข้า dps368_presenter_start()

ลองที่อยู่ default ก่อน (0x77) ไม่ตอบค่อยลอง alternate (0x76 จากขา SDO) — ใช้ได้ทั้งสองแบบ strap

แนวคิด — poll จริงคือ lv_timer เดียว ไม่ใช่ FreeRTOS task

lv_timer_create(dps368_poll_sensor_cb, 1000, NULL) — รันบน LVGL thread เดียวกัน กับที่วาดจอ

อ่าน I2C แบบ blocking ตรงในนั้นเลย ไม่มี queue หรือ lv_async_call() — เซนเซอร์เดียว ไม่คุ้มความซับซ้อนของ task แยก

แนวคิด — แยก "ยังไม่พร้อม" จาก error จริง

XENSIV_DPS3XX_RSLT_ERR_DATA_NOT_READY → false แต่ ไม่ใช่ error (แค่ยังไม่ถึงรอบ conversion)

error code อื่นถือเป็นปัญหาจริง แสดงบน status label — ถ้าไม่แยกจะกระพริบ error ทุกวินาทีที่ยังไม่ถึงรอบอ่าน

แนวคิด — ทักษะที่ฝึกในบทเรียนนี้

บทเรียนนี้พัฒนาทักษะต่อไปนี้ (ตามระดับ 1–5 ของหลักสูตร)

• proto.i2c (ระดับ 2)
• sys.sensors-actuators (ระดับ 2)
• prog.design-patterns (ระดับ 2)
• lang.c (ระดับ 2)

ตัวอย่างสมบูรณ์ — lv_timer เดียวที่ poll

โค้ดจาก tesaiot/developer-hub (Apache-2.0) · commit 9a8e3ed · dps368_presenter.c

static void dps368_poll_sensor_cb(lv_timer_t *timer)
{
    (void)timer;

    dps368_sample_t sample;
    bool has_new_sample = dps368_reader_poll(&sample);

    if (has_new_sample)
    {
        dps368_view_update_sample(&sample);
        return;
    }

    cy_rslt_t rslt = dps368_reader_get_last_error();
    if (CY_RSLT_SUCCESS == rslt)
    {
        return;   /* not-ready is not an error */
    }
    /* ... real error -> update status label ... */
}

ตัวอย่างสมบูรณ์ — แยก not-ready จาก error

dps368_reader.c

if (CY_RSLT_SUCCESS == rslt)
{
    s_last_sample.pressure_hpa = pressure_hpa;
    s_last_sample.sample_count++;
    if (NULL != out_sample) { *out_sample = s_last_sample; }
    return true;
}

/* At low sample rate, polling can happen before
 * conversion is ready. */
if (rslt == XENSIV_DPS3XX_RSLT_ERR_DATA_NOT_READY)
{
    s_last_error = CY_RSLT_SUCCESS;
    return false;
}

s_last_error = rslt;
return false;

จุดที่มักพลาด

• คิดว่ามี FreeRTOS task แยก poll ทุก 100 ms — จริงคือ lv_timer เดียวที่ 1000 ms อ่าน I2C แบบ blocking ตรง ๆ
• ถือว่า DATA_NOT_READY เป็น error — ต้องแยกออกเสมอ เป็นแค่สัญญาณว่ายังไม่ถึงรอบ conversion
• ลืมว่าเซนเซอร์มีสองที่อยู่ I2C (0x77/0x76) — hard-code ตัวเดียวจะใช้ไม่ได้กับบางบอร์ด

ตัวอย่างสมบูรณ์ — build และ flash

# ในโฟลเดอร์ master template (ดูบทเรียน 1.1)
# 1) ลบไฟล์ของ episode เก่าใน proj_cm55/apps/
# 2) คัดลอกไฟล์ทั้งหมดของ episode นี้ลงใน proj_cm55/apps/
make build
make program     # flash ผ่าน KitProg3

หรือเปิด ตัวอย่างนี้บน Developer Hub แล้ว flash เฟิร์มแวร์สำเร็จรูป

ฝึกเติม / แล็บ

1. ทาย ก่อนแก้: เลือกค่าหนึ่งค่าที่ README ของตัวอย่างอธิบายไว้ในส่วน How แล้วเขียนว่าจะเห็นอะไรเปลี่ยนบนจอหรือใน log
2. แก้และรัน build + flash แล้วเทียบกับที่ทายไว้ ถ้าไม่ตรง ให้หาว่าเข้าใจส่วนไหนผิด
3. ทำเพิ่ม ต่อยอดหนึ่งอย่างที่ตัวอย่างยังไม่มี แล้วเก็บภาพหรือวิดีโอไว้ใน portfolio

เช็กความเข้าใจ

• ชั้น presenter ทำอะไรที่ view ไม่ทำ
• ความดันควรเปลี่ยนอย่างไรเมื่อยกบอร์ดขึ้นสูงหนึ่งชั้นตึก
• ถ้าเซนเซอร์ตอบ I2C ไม่ได้ ข้อความผิดพลาดควรขึ้นที่ชั้นใด

คำตอบอยู่ใน README ของตัวอย่างและในโค้ด ถ้าตอบข้อใดไม่ได้ ให้กลับไปอ่านส่วน Why / What / How อีกครั้ง

ไปต่อ

• ทบทวนเป้าหมายทั้ง 3 ข้อของบทเรียนนี้ก่อนไปต่อ
• ถ้าตอบคำถามหน้าที่แล้วไม่ได้ครบ กลับไปอ่าน README ของตัวอย่างส่วน Why / What / How อีกครั้ง
• พร้อมแล้วไปเปิดบทเรียนถัดไปในโมดูลเดียวกัน

แหล่งอ้างอิง

• README ของ episode · โฟลเดอร์โค้ด · commit 9a8e3ed
• เปิดตัวอย่างนี้บน Developer Hub
• โค้ดเป็นของ Developer Hub และอ้างอิงด้วยลิงก์ ไม่ได้คัดลอกเข้าคลังนี้

เครดิต

"TESAIoT Firmware Stack: เฟิร์มแวร์ภาษา C บน TESAIoT Dev Kit" จาก TESA Open Knowledge โดยสมาคมสมองกลฝังตัวไทย (Thai Embedded Systems Association: TESA) https://github.com/tesaiot/tesa-qualification-program สัญญาอนุญาต CC BY-NC 4.0

ตัวอย่างโค้ดเป็นผลงานของ TESAIoT Firmware Stack โดยสมาคมสมองกลฝังตัวไทย (TESA) ใน tesaiot/developer-hub รายละเอียดการให้เครดิตอยู่ที่ ATTRIBUTION.md

ภาพหน้าจอในสไลด์นี้มาจาก tesaiot/developer-hub (int_ep01_dps368_monitor) ที่ commit 9a8e3ed