แล็บ: ติดตั้ง Twin บน VS Code และเซสชันแรก

วิดีโอประกอบ

ดูบน YouTube (เปิดในแท็บใหม่)

BS-02: Install BitStream Studio ผศ.ดร.สันติ นุราช (KMUTT)
BS-03: Update Bitstream Studio ผศ.ดร.สันติ นุราช (KMUTT)
BS-04: BitStream Firmware Update ผศ.ดร.สันติ นุราช (KMUTT)
BS-05: Install BitStream Studio from VSIX ผศ.ดร.สันติ นุราช (KMUTT)

วิดีโอโดย ผศ.ดร.สันติ นุราช ภาควิชาวิศวกรรมระบบควบคุมและเครื่องมือวัด คณะวิศวกรรมศาสตร์ มหาวิทยาลัยเทคโนโลยีพระจอมเกล้าธนบุรี (KMUTT) · ดูทั้งชุดใน playlist AIoT Foundation

Course 2 · Module 2
Type: Hands-on (install + bind + first live session)
Suggested time: 2–3 ชั่วโมง (รวมติดตั้ง)

Read first: Lesson · Cheatsheet · ← Table of Contents · ← M01 · M03 →

Useful references during the lab

เอกสาร	ใช้เมื่อ
Hackathon README	ติดตั้ง VSIX / flash HEX
Bitstream Studio Marketplace	Path A ติดตั้ง
Course 1 M02	ถ้าต้อง build/flash เอง

Lab Goals

Extension Bitstream Studio พร้อมใช้
มี workspace ที่ชี้โปรเจกต์เฟิร์มแวร์หรือแพ็กแล็บได้
เซสชันแรกสำเร็จอย่างน้อยหนึ่งเส้น: Simulator หรือ Bitstream
เห็น visualization / ค่าขยับ และบันทึกหลักฐาน
กรอก vscode-twin-setup.md

Lab A — Install (required)

ติดตั้ง VS Code (หรือ Cursor)
ติดตั้ง Bitstream Studio:
- Path A: Marketplace, หรือ
- Path B: VSIX จาก Hackathon vsix/
Reload → Command Palette → Open Bitstream Studio
(ถ้าจะใช้โหมดไม่มีบอร์ด) ติดตั้ง Bitstream Simulator ตามคู่มือของชุดที่ใช้
ทำขั้นตอน CA/credentials เฉพาะเมื่อ คู่มือรอบนั้นระบุ
(แนะนำ) รัน Download Free Assets from GitHub หนึ่งครั้งถ้าจะใช้โมเดล 3D จาก ternion-3d-assets-free

Pass when: เปิด Bitstream Studio ได้ และเห็น toolbar แหล่งข้อมูล / Link

Lab B — Workspace bind (required)

สร้างหรือเปิดโฟลเดอร์ workspace ตามโครงในบทเรียน
วางหรือลิงก์โฟลเดอร์ firmware/ (หรือ clone Hackathon เป็นอ้างอิงเวอร์ชัน)
เปิด Bitstream Studio จากหน้าต่าง workspace เดียวกัน
จด path โปรเจกต์ + เวอร์ชัน VSIX/HEX ลง setup sheet

Pass when: คุณอธิบายได้ว่า “เฟิร์มแวร์อยู่โฟลเดอร์ไหน” และ “โฮสต์ Twin เปิดจากหน้าต่างไหน”

Lab C — First live session (required)

ทำอย่างน้อย หนึ่ง เส้นทางให้จบ — แนะนำเริ่ม Simulator ถ้าบอร์ดยังไม่พร้อม

C1 — Simulator path

Toolbar → Simulator
Start Simulator / Streaming
Link / Connect
เปิด Sensor Telemetry (หรือแผงที่กำหนด)
แคปหน้าจอ: ค่าขยับ + สถานะ Link

C2 — Bitstream path (board)

Flash HEX ที่จับคู่ VSIX (hex/ + Flasher)
Toolbar → Bitstream · เลือก COM
Link / Connect จน handshake
ยืนยันกราฟ/ค่าจากบอร์ด
แคปหน้าจอ

Pass when: มีหลักฐาน live อย่างน้อยหนึ่งเส้นทาง (สกรีนช็อตหรือคลิปสั้น)

Lab D — Observe & switch (recommended)

ถ้าทำได้ทั้ง Simulator และ Bitstream — สลับโหมดหนึ่งครั้ง แล้วยืนยันว่าข้อมูลเก่าถูกล้าง/ไม่ปะปน
เปิด Output / log สั้น ๆ เมื่อมี error แล้วจดข้อความ
(ทางเลือก) เปิดหน้า web-app/ จาก Hackathon ตามคู่มือ — ชี้ว่าเป็น Visualization ชั้นนอก

Pass when (recommended): มีโน้ต 3–5 บรรทัดว่าแยกปัญหาเป็นชั้นอย่างไร

Deliverables checklist

Lab A–C ผ่าน
vscode-twin-setup.md กรอกครบ
หลักฐานเซสชันแรก (สกรีนช็อต)
(แนะนำ) Lab D

Troubleshooting

อาการ	แนวทาง
ไม่เห็นคำสั่ง Open Bitstream Studio	ติดตั้งผิด VSIX / ยังไม่ Reload / เปิดคนละแอป
Session / Link ไม่ขึ้น	Shutdown Backend Services แล้วเปิดใหม่ · ตรวจพอร์ต 9998
Simulator ไม่มีค่า	Simulator ยังไม่ Streaming · โหมดยังเป็น Bitstream
Bitstream ว่าง	COM ผิด · HEX ไม่จับคู่ · baud / สาย USB
พอร์ตถูกใช้งานอยู่	ปิด editor อื่นที่เป็น owner · Shutdown backends
UI โหลดแต่กราฟนิ่ง	เปิดผิด workspace/แผง · ยังไม่ Link

Lesson · Cheatsheet · Table of Contents · M03 →

อ้างอิงบทเรียนนี้

ถ้านำบทเรียนนี้ไปสอน ทำสไลด์ หรือทำเอกสารต่อ ให้อ้างอิงด้วยข้อความนี้ ถ้าดัดแปลงเนื้อหา ให้เติม (ดัดแปลง)ต่อท้ายชื่อบทเรียน

"แล็บ: ติดตั้ง Twin บน VS Code และเซสชันแรก" จาก TESA Open Knowledge โดยสมาคมสมองกลฝังตัวไทย (Thai Embedded Systems Association: TESA) https://github.com/tesaiot/tesa-qualification-program สัญญาอนุญาต CC BY-NC 4.0

ข้อความอ้างอิงภาษาอังกฤษ: "Lab: Install VS Code Twin and First Session" from TESA Open Knowledge by the Thai Embedded Systems Association (TESA), https://github.com/tesaiot/tesa-qualification-program, licensed under CC BY-NC 4.0

ลิงก์บทเรียน: https://tesaiot.github.io/tesa-qualification-program/courses/digital-twin/m02-vscode-twin/l02-lab/

บทเรียนนี้ดัดแปลงจากต้นฉบับด้านล่าง เมื่ออ้างอิงให้คงเครดิตต้นฉบับไว้ด้วย
https://github.com/drsanti/TESAIoT-Courses/blob/287c21814ba8c75f693136616dcd270349a15966/C2/M02/lab.md · Original content by Asst. Prof. Dr. Santi Nuratch (ผศ.ดร.สันติ นุราช), KMUTT. Course 2 (C2/) of drsanti/TESAIoT-Courses. TESA funded the work and holds the rights; published here under CC BY-NC 4.0. The upstream repository carries no licence file. Text kept faithful; structure, front matter, quizzes and notes added by TESA Open Knowledge.

วิธีอ้างอิง TESA ฉบับเต็ม

เนื้อหาเผยแพร่ภายใต้ CC BY-NC 4.0 นำไปใช้ต่อในงานที่ไม่ใช่เพื่อการค้าได้ โปรดอ้างอิงสมาคมสมองกลฝังตัวไทย (TESA) ทุกครั้ง · วิธีอ้างอิง TESA