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)




ปัญหา
ระหว่างทำงานกับ Claude Code มีข้อมูลบางอย่างที่อยากรู้ตลอด เช่น โควตาเหลือเท่าไร เครื่องทำงานหนักแค่ไหน แต่การเปิดหน้าต่างไว้ดูบนจอ Mac ก็ไปบังงานที่ทำอยู่ จึงอยากได้จอแยกวางบนโต๊ะ ที่เหลือบมองแล้วรู้ทันที
Requirement
- อ่านได้ในแวบเดียว: แต่ละหน้าต้องตอบคำถามแรกได้โดยไม่ต้องกดปุ่ม
- ไม่พึ่ง WiFi: ใช้สาย USB-C ที่เสียบอยู่แล้วเป็นช่องทางหลัก WiFi เป็นแค่ทางสำรอง
- บอกตรง ๆ เมื่อข้อมูลเก่า: ตัวเลขที่ค้างหรือไม่อัปเดตต้องไม่แสดงเหมือนเป็นของสด
- ดูแลตัวเองได้: ถ้าค้าง ต้องกู้คืนเองโดยไม่ต้องมีคนไปถอดสาย
- ไม่เปิดข้อมูลของเครื่องให้คนอื่นในเครือข่าย: 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 ของโปรเจกต์ถูกลบหรือสร้างใหม่
ทำไมส่ง 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 ถ้าไม่ได้อัปเดตเกิน 30 วินาที จะเปลี่ยนเป็น
not answeringเพราะคำว่า "จอเปิดอยู่" ที่ค้างมาหนึ่งนาทีหลังเครื่องหลับ คือข้อมูลที่ผิด และผิดในทางที่หลอกว่าเครื่องยังทำงาน - ตัวเลขโควตาจากไฟล์ของแอป Claude ช้ากว่าความจริงได้ 2–3% (วัดจริง: เพิ่มราว 3–4% ทุก 15 นาที) จอจึงแสดงอายุของข้อมูลไว้ด้วยเสมอ
- เลือกไม่ใช้การ ping ผ่าน WiFi เพื่อดูว่า Mac ตื่นอยู่หรือไม่ เพราะ macOS มี Bonjour sleep proxy ที่ตอบแทนเครื่องที่หลับอยู่ ผลจะบอกว่าตื่นทั้งที่หลับ
การทดสอบ
ชุดทดสอบรันบน Mac ได้โดยไม่ต้องต่อบอร์ด ใช้แค่ C++17 compiler และเน้นสองจุดที่ผิดได้ง่ายที่สุด คือการตัดบรรทัดของข้อความแจ้งเตือน และการแบ่งความกว้างของกราฟ CPU รายคอร์
- ทดสอบโค้ดจริงของ firmware: คอมไพล์ header ตัวเดียวกับที่บอร์ดใช้ ไม่ใช่สำเนาที่อาจเพี้ยนไปทีหลัง
- วัดความกว้างตัวอักษรด้วย algorithm และฟอนต์ตัวจริง: ถ้าใช้วิธีคำนวณแบบง่าย test จะผ่านบนเครื่อง แต่ข้อความล้นบนจอจริง
- Input สุ่ม 200,000 ชุด ตรวจว่าไม่มีบรรทัดล้นกรอบ ไม่มีบรรทัดว่าง และตัวอักษรไม่หายหรือเพิ่มขึ้นมา
- จำนวนคอร์ตั้งแต่ 1 ถึงค่าสูงสุด ต้องแสดงบนจอได้ครบทุกค่า
- ทดสอบตัว test เอง: ใส่ bug โดยตั้งใจ 6 แบบ เช่น ให้บรรทัดล้น ทำตัวอักษรหาย หรือนับจำนวนบรรทัดผิดไปหนึ่ง แต่ละแบบต้องถูกจับได้ด้วย assertion คนละตัว
Security
- Server ฝั่ง Mac รับ request จากนอกเครื่องเฉพาะเมื่อมี token ที่สร้างตอนรันครั้งแรก
- หน้าเว็บบนมือถือดึงข้อมูลผ่าน server ของตัวเอง token จึงไม่ต้องออกจากเครื่อง Mac
- ข้อจำกัดที่เขียนเปิดเผยไว้: token ส่งผ่าน HTTP ธรรมดา กันการสุ่มเข้ามาอ่านได้ แต่กันคนที่ดักดู traffic ไม่ได้ การใช้ TLS ต้องดูแล certificate บนอุปกรณ์ที่ไม่มีนาฬิกาตอนบูต จึงเลือกไม่ทำ
สิ่งที่นำไปใช้กับงาน QA ได้
- Bug ที่สำคัญที่สุดมาจากการใช้งานจริงในสภาพจริง เช่น เครื่องหลับกลางคืน หรือสายถูกพักกลางทาง ซึ่ง test บนโต๊ะไม่มีวันเจอ
- ทดสอบกับโค้ดและข้อมูลตัวจริง ไม่ใช่ model ที่ทำให้ง่ายลง
- ตรวจว่า test จับ bug ได้จริง ด้วยการใส่ bug เข้าไปเอง
- ระบบที่ดีบอกได้ว่าตัวเองไม่รู้ ดีกว่าแสดงข้อมูลเก่าเหมือนเป็นของใหม่