Case study · Embedded / IoT

จอเล็กบนโต๊ะทำงาน: ESP32 ที่รู้ว่า Mac ข้าง ๆ ตื่นอยู่หรือไม่

จอ LilyGO T-Display-S3 ขนาด 320×170 วางข้างคีย์บอร์ด แสดงสิ่งที่อยากเหลือบดูระหว่างทำงาน ได้แก่ เวลา อากาศ โควตา Claude Code ที่เหลือ สถานะของ Mac และ pomodoro timer ทั้งหมดวิ่งผ่านสาย USB-C เส้นเดียว ไม่ต้องใช้ WiFi

บทบาท
เจ้าของงาน: กำหนดสิ่งที่ต้องการ ใช้งานจริงบนโต๊ะ รายงานอาการผิดปกติ และตรวจรับทุกการแก้
ช่วงเวลา
ส.ค.–ต.ค. 2026 · 50 commits
เครื่องมือ
ESP32-S3 (C++, PlatformIO, TFT_eSPI), Python stdlib, macOS launchd, Claude Code

โค้ดเขียนร่วมกับ Claude Code (Claude Opus) ภายใต้ requirement และการตรวจรับของผม · ภาพหน้าจอดึงจาก framebuffer ของบอร์ดจริง · โค้ดเปิดเป็น open source (MIT)

หน้า flip: นาฬิกาแบบ split-flap 21:50 อุณหภูมิ 27 องศา รู้สึกเหมือน 32 องศา
flip นาฬิกาแบบป้ายพลิก และอุณหภูมิ
หน้า usage: โควตา Claude Code 5 ชั่วโมงใช้ไป 30% และ 7 วันใช้ไป 57% พร้อมเวลารีเซ็ต
usage โควตา Claude Code 5 ชม. และ 7 วัน
หน้า mac: แบตเตอรี่ หน้าจอ หน่วยความจำ ดิสก์ และกราฟแท่งต่อ CPU core
mac แบต จอ หน่วยความจำ ดิสก์ และ CPU รายคอร์
หน้า pomo: pomodoro timer ทำงาน 25 นาที พัก 5 นาที
pomo pomodoro ที่อยู่บนจอนี้ ไม่ใช่บนเครื่องที่กำลังทำงาน

ปัญหา

ระหว่างทำงานกับ Claude Code มีข้อมูลบางอย่างที่อยากรู้ตลอด เช่น โควตาเหลือเท่าไร เครื่องทำงานหนักแค่ไหน แต่การเปิดหน้าต่างไว้ดูบนจอ Mac ก็ไปบังงานที่ทำอยู่ จึงอยากได้จอแยกวางบนโต๊ะ ที่เหลือบมองแล้วรู้ทันที

Requirement

  1. อ่านได้ในแวบเดียว: แต่ละหน้าต้องตอบคำถามแรกได้โดยไม่ต้องกดปุ่ม
  2. ไม่พึ่ง WiFi: ใช้สาย USB-C ที่เสียบอยู่แล้วเป็นช่องทางหลัก WiFi เป็นแค่ทางสำรอง
  3. บอกตรง ๆ เมื่อข้อมูลเก่า: ตัวเลขที่ค้างหรือไม่อัปเดตต้องไม่แสดงเหมือนเป็นของสด
  4. ดูแลตัวเองได้: ถ้าค้าง ต้องกู้คืนเองโดยไม่ต้องมีคนไปถอดสาย
  5. ไม่เปิดข้อมูลของเครื่องให้คนอื่นในเครือข่าย: request ที่มาจากนอกเครื่องต้องมี token

สิ่งที่สร้าง

ส่วนหน้าที่
Firmware (C++)วาดหน้าจอ 4 หน้า สลับหน้าเองตามสถานการณ์ และกู้คืนตัวเองด้วย watchdog
usb_net_bridge.pyตอบ request ของบอร์ดผ่านสาย USB เช่น ขอเวลา หรือขอให้ไปดึงข้อมูลอากาศแทน
usage_server.pyอ่านโควตา Claude Code จาก 3 แหล่ง แล้วเลือกตัวที่ใหม่ที่สุด
mac_stats_server.pyส่งสถานะเครื่อง (แบต หน่วยความจำ ดิสก์ CPU รายคอร์ จอเปิดหรือปิด) และรับข้อความแจ้งเตือนจากโปรแกรมอื่นในเครื่อง
หน้าเว็บสำหรับมือถือข้อมูลชุดเดียวกันบนมือถือที่วางตะแคงข้างโต๊ะ เปิดด้วยการดับเบิลคลิก ปิดหน้าต่างแล้ว server หายไปด้วย

โปรแกรมฝั่ง Mac ใช้ Python stdlib เท่านั้น และรันด้วย python ของระบบ จึงยังทำงานได้แม้ virtual environment ของโปรเจกต์ถูกลบหรือสร้างใหม่

หน้าเว็บบนมือถือแนวนอน: นาฬิกา โควตา Claude Code, pomodoro และสถานะ MacBook
หน้าเว็บสำหรับมือถือแนวนอน ใช้ข้อมูลชุดเดียวกับจอบนโต๊ะ

ทำไมส่ง request ผ่าน USB แทนที่จะต่อเน็ตผ่าน USB

Arduino core ของบอร์ดนี้ไม่มี USB network class และไม่มี PPP บอร์ดจึงส่ง packet ผ่านสายไม่ได้ ทางออกคือออกแบบ protocol ง่าย ๆ (@REQ / @RES) ที่ส่ง "คำขอ" ผ่าน serial แล้วให้ Mac ไปดึงข้อมูลแทน ไม่ต้องแก้หรือ build core ใหม่

Defect ที่เจอและการแก้

ส่วนใหญ่เจอจากการใช้งานจริงบนโต๊ะ ไม่ใช่จากการอ่านโค้ด

อาการสาเหตุการแก้
จอขึ้น OFFLINE ทั้งที่สายยังเสียบอยู่ และไม่หายเองคำตอบถูกตัดกลางทาง (เช่น Mac พักบัส USB) บอร์ดรอ byte ที่ไม่มีวันมา ข้อความถัดไปทั้งหมดจึงถูกอ่านผิด watchdog ก็ไม่ช่วย เพราะ loop ยังวิ่งอยู่ทิ้ง frame ที่ค้างเกิน 2 วินาทีแล้วเริ่มใหม่ และอ่านเฉพาะ byte ที่มีอยู่จริง
กดปุ่มแล้วจอไม่ตอบสนองการอ่าน serial ของ library รอ 1 วินาทีโดยไม่ปล่อย CPU ปุ่มจึงถูกอ่านแค่ 0.5 ครั้งต่อวินาทีเปลี่ยนวิธีอ่านเป็นแบบไม่รอ (เป็นการแก้ชุดเดียวกับข้อบน)
โควตาขึ้น 0% ทั้งที่ใช้ไปเยอะแล้วบัญชีเดียวมีได้หลาย organization ข้อมูลล่าสุดบังเอิญเป็นของ org ที่ไม่ได้ใช้ ซึ่งมีค่าเป็น 0%เลือก org ที่มีข้อมูลมากที่สุด แทนการเลือกข้อมูลล่าสุด
เวลานับถอยหลังของโควตาหายเป็นช่วง ๆแหล่งข้อมูลหนึ่งไม่มีเวลารีเซ็ตยืมเวลารีเซ็ตจากอีกแหล่ง ถ้าเวลานั้นยังไม่ผ่านไป
ตอนกลางคืนจอสว่างค้างที่หน้าโควตา เหมือนมีคนนั่งทำงานใช้ "Mac ยังตอบ" เป็นตัวบอกว่ามีคนอยู่ แต่บางแอปกันเครื่องหลับ และ Power Nap ปลุกเครื่องทุก 15 นาทีดูจาก "จอของ Mac ดับหรือไม่" แทน เพราะตรงกับสิ่งที่คนเห็นว่าเครื่องหลับ

บอกตรง ๆ ว่าข้อมูลเก่าแค่ไหน

การทดสอบ

ชุดทดสอบรันบน Mac ได้โดยไม่ต้องต่อบอร์ด ใช้แค่ C++17 compiler และเน้นสองจุดที่ผิดได้ง่ายที่สุด คือการตัดบรรทัดของข้อความแจ้งเตือน และการแบ่งความกว้างของกราฟ CPU รายคอร์

Security

สิ่งที่นำไปใช้กับงาน QA ได้

โค้ด

ดูโค้ด firmware, โปรแกรมฝั่ง Mac และชุดทดสอบบน GitHub