Serial Protocol

หน้านี้ใช้สำหรับนักพัฒนาที่ต้องการสร้างแอปควบคุม C5TAKO™ ผ่าน USB Serial หรือ BLE Serial

เริ่มต้นอย่างเร็ว

เชื่อมต่อ USB Serial หรือ BLE Serial
เปิด Notification ที่ TX หากใช้ BLE
ส่งคำสั่ง /HELP เพื่ออ่านคำสั่งของ Firmware ที่กำลังใช้งาน
ส่ง /PING เพื่อตรวจการเชื่อมต่อ
ส่ง /STATUS เพื่ออ่านสถานะเครื่อง

Protocol อาจเปลี่ยนตามเวอร์ชัน Firmware ให้ใช้ผลจาก /HELP ของเครื่องจริงเป็นแหล่งอ้างอิงก่อนผูกคำสั่งเข้ากับแอป

การเชื่อมต่อ

USB Serial

รายการ	ค่า
Baud rate	`115200`
รูปแบบข้อมูล	Text แบบทีละบรรทัด
จบบรรทัด	`\n` หรือ CRLF
Prefix คำสั่ง	`/`

ตั้งค่า Serial Monitor ให้ส่ง Newline หรือ Both NL & CR หากเครื่องไม่ตอบสนอง ให้ตรวจการตั้งค่าจบบรรทัดก่อน

BLE Serial

BLE ใช้คำสั่งและ Response ชุดเดียวกับ USB Serial

รายการ	ค่า
Device name	`C5TAKO Serial`
Service UUID	`6E400001-B5A3-F393-E0A9-E50E24DCCA9E`
RX — เขียนคำสั่ง	`6E400002-B5A3-F393-E0A9-E50E24DCCA9E`
TX — อ่านและรับ Notification	`6E400003-B5A3-F393-E0A9-E50E24DCCA9E`

ลำดับการทำงาน:

ค้นหาอุปกรณ์ชื่อ C5TAKO Serial
เชื่อมต่อ Service UUID
เปิด Notification ที่ TX
เขียนคำสั่งไปที่ RX
รองรับ Response ที่แบ่งเป็นหลาย BLE Packet

รูปแบบ Response

[LEVEL] [MODULE] fields...

Level	ความหมาย
`OK`	คำสั่งสำเร็จ
`ERR`	คำสั่งล้มเหลว โดยปกติมี `CODE=` และ `MSG=`
`INFO`	ข้อความแจ้งสถานะ
`DATA`	ข้อมูล JSON
`STREAM`	ข้อมูลสถานะแบบต่อเนื่อง

ตัวอย่าง:

[OK] [SERIAL] MSG="pong" uptime=123456
[ERR] [DEAUTH] CODE=NO_AP_SCAN MSG="scan ap first"
[DATA] [STATUS] {"wifi":"AP+STA","scan":{"aps":4,"stas":0}}

อ่านข้อมูลเป็น Stream อย่าสมมติว่า 1 Read เท่ากับ 1 Response แยก Parser ของข้อความ Response ออกจาก JSON payload และรองรับ BUSY, Timeout และการเชื่อมต่อหลุด

คำสั่งพื้นฐาน

คำสั่ง	ใช้ทำอะไร
`/HELP`	แสดงคำสั่งที่ Firmware รุ่นนั้นรองรับ
`/PING`	ตรวจว่า Serial Command ทำงานอยู่
`/STATUS`	อ่านสถานะรวมของเครื่อง
`/STATUS <module>`	อ่านสถานะของ Module ที่ระบุ หาก Firmware รองรับ
`/STOP`	หยุด Runtime ทั้งหมด
`/STOP <module>`	หยุด Runtime ของ Module ที่ระบุ
`/REBOOT [DELAY=ms]`	รีสตาร์ทเครื่องทันทีหรือหลังหน่วงเวลาตามที่ระบุ

Scan และเลือกเป้าหมาย

ค้นหา AP และ STA

/SCAN AP [CHANNEL=n]
/SCAN STA

/SCAN AP ค้นหา Access Point หากไม่ระบุ Channel จะสแกนหลาย Channel ส่วน /SCAN STA ค้นหา Client ที่เกี่ยวข้องกับข้อมูล AP ที่สแกนไว้

อ่านผลการสแกน

/RESULT AP
/RESULT STA

คำสั่งนี้อ่านผลล่าสุดโดยไม่เริ่มสแกนใหม่ ดัชนีรายการเริ่มจาก 0

เลือกรายการ

/SELECT AP <ids|ALL|CLEAR>
/SELECT STA <ids|ALL|CLEAR>

ตัวอย่าง:

/SELECT AP 0,1
/SELECT STA 0
/SELECT AP ALL
/SELECT STA CLEAR

เริ่มและหยุด Runtime

คำสั่งที่เริ่มการทำงานใช้รูปแบบนี้:

/START <MODULE> [MODE] [ARGS...]

Wi‑Fi Monitor และ PCAP

/START MONITOR NORMAL [HOP=ON] [INTERVAL=500]
/START MONITOR SAVE [HOP=ON] [INTERVAL=500]
/START PCAP ACTIVE
/START PCAP TARGET

SAVE บันทึกข้อมูล Monitor เป็น PCAP หากมีพื้นที่เก็บข้อมูล ส่วน TARGET ต้องมีข้อมูล AP ที่สแกนและเลือกไว้แล้ว

เครื่องมือ Wi‑Fi อื่น

/START DEAUTH ALL|MASS|AP|STA
/START BEACON RANDOM|ALL|AP|PREFIX <name>|LIST <ssid1,ssid2>
/START AUTH ALL|AP
/START ASSOC ALL|AP
/START CSA ALL|AP|STA
/START FINDHIDDEN
/START WHITELIST AP|ALL

Portal

/START PORTAL NORMAL SSID="Free WiFi" [TEMPLATE=basic|HTML=/path.html|INLINE="<html>..."]
/START PORTAL VERIFY SSID="Target" [BSSID=xx] [CHANNEL=n] [TEMPLATE=password_only|HTML=/path.html|INLINE="<html>..."]
/PORTAL STATUS
/PORTAL DEAUTH TOGGLE|ON|OFF

ใช้คำสั่ง Portal เฉพาะใน Lab และใช้ข้อมูลทดสอบที่ไม่ใช่ข้อมูลส่วนตัวของผู้อื่น

Bluetooth และการตรวจจับอื่น

/START BLE_MONITOR [ACTIVE|PASSIVE]
/START BLE_SPAM IOS|SAMSUNG|ANDROID|MICROSOFT|RANDOM
/START BAD_BLE
/START MODEL_FIND
/START AIRTAG
/START CSI_MOTION [CHANNEL=n] [MIN_RSSI=-85]

หยุด Runtime

/STOP
/STOP MONITOR
/STOP BLE_SPAM

หากแอปมีปุ่มหยุดฉุกเฉิน ให้ส่ง /STOP และ /BTN RELEASE ALL เมื่อหยุดการเชื่อมต่อระหว่างการกดปุ่มค้าง

ควบคุมหน้าจอ

/BTN <UP|DOWN|LEFT|RIGHT|OK|BACK> TAP|HOLD|RELEASE
/BTN RELEASE ALL

ตัวอย่าง:

/BTN UP TAP
/BTN OK HOLD
/BTN RELEASE ALL

หากแอปขาดการเชื่อมต่อระหว่างคำสั่ง HOLD ให้ส่ง /BTN RELEASE ALL หลังเชื่อมต่อใหม่

ขอภาพหน้าจอ

/FRAME GET [FMT=GRAY2|MONO] [COMP=RLE|RAW] [CHUNK=512]

แอปต้องประกอบ Chunk ตามลำดับและตรวจขนาดข้อมูลก่อนนำภาพไปแสดง

Status Stream

/STREAM ON [INTERVAL=ms] [EVENTS=ON] [STATS=ON]
/STREAM OFF

ช่วงเวลา INTERVAL รองรับ 100–60000 มิลลิวินาที ควรส่ง /STREAM OFF ก่อนตัดการเชื่อมต่อเมื่อไม่ต้องการข้อมูลต่อเนื่อง

คำสั่งไฟล์

/FILE LIST [PATH=/]
/FILE INFO <path>
/FILE STORAGE
/FILE DELETE <path>
/FILE RENAME <old> <new>
/FILE GET <path> [CHUNK=512] [LOOPS=1]
/FILE RECV <path> LEN=<bytes> [CHUNK=512] [OVERWRITE=ON] [TIMEOUT=30000]

คำสั่งที่ใช้บ่อย:

คำสั่ง	ใช้ทำอะไร
`/FILE LIST`	แสดงรายการไฟล์
`/FILE INFO`	อ่านข้อมูลไฟล์
`/FILE STORAGE`	อ่านพื้นที่ทั้งหมด พื้นที่ใช้แล้ว และพื้นที่ว่าง
`/FILE DELETE`	ลบไฟล์
`/FILE RENAME`	เปลี่ยนชื่อไฟล์
`/FILE GET`	ส่งไฟล์จากเครื่องออกไปยังแอป
`/FILE RECV`	รับไฟล์จากแอปเข้าสู่เครื่องตาม Protocol ที่ Firmware รองรับ

รูปแบบ Stream ของ /FILE RECV:

[BEGIN] [FILE] name="/x" len=n chunk=n
DATA chunks
[END] [FILE]

ก่อนใช้คำสั่งไฟล์ ให้ตรวจผล /HELP และ /FILE STORAGE จากเครื่องจริง เพราะความสามารถและชื่อพื้นที่เก็บข้อมูลอาจเปลี่ยนตาม Firmware

ลำดับการเชื่อมต่อที่แนะนำ

/HELP
/PING
/STATUS
/SCAN AP
/RESULT AP
/SELECT AP 0
/START MONITOR NORMAL
/STREAM ON INTERVAL=1000 EVENTS=ON STATS=ON
/STREAM OFF
/STOP

เมื่อเชื่อมต่อใหม่ทุกครั้ง ให้ตรวจ Firmware version, ผล /HELP และสถานะจาก /STATUS ก่อนใช้คำสั่งอื่น

🚀 เริ่มต้นใช้งาน

📖 เมนูบนเครื่อง

🆘 ช่วยเหลือ

🧑‍💻 สำหรับนักพัฒนา

เริ่มต้นอย่างเร็ว

การเชื่อมต่อ

USB Serial

BLE Serial

รูปแบบ Response

คำสั่งพื้นฐาน

Scan และเลือกเป้าหมาย

ค้นหา AP และ STA

อ่านผลการสแกน

เลือกรายการ

เริ่มและหยุด Runtime

Wi‑Fi Monitor และ PCAP

เครื่องมือ Wi‑Fi อื่น

Portal

Bluetooth และการตรวจจับอื่น

หยุด Runtime

ควบคุมหน้าจอ

ขอภาพหน้าจอ

Status Stream

คำสั่งไฟล์

ลำดับการเชื่อมต่อที่แนะนำ

​เริ่มต้นอย่างเร็ว

​การเชื่อมต่อ

​USB Serial

​BLE Serial

​รูปแบบ Response

​คำสั่งพื้นฐาน

​Scan และเลือกเป้าหมาย

​ค้นหา AP และ STA

​อ่านผลการสแกน

​เลือกรายการ

​เริ่มและหยุด Runtime

​Wi‑Fi Monitor และ PCAP

​เครื่องมือ Wi‑Fi อื่น

​Portal

​Bluetooth และการตรวจจับอื่น

​หยุด Runtime

​ควบคุมหน้าจอ

​ขอภาพหน้าจอ

​Status Stream

​คำสั่งไฟล์

​ลำดับการเชื่อมต่อที่แนะนำ

เริ่มต้นอย่างเร็ว

การเชื่อมต่อ

USB Serial

BLE Serial

รูปแบบ Response

คำสั่งพื้นฐาน

Scan และเลือกเป้าหมาย

ค้นหา AP และ STA

อ่านผลการสแกน

เลือกรายการ

เริ่มและหยุด Runtime

Wi‑Fi Monitor และ PCAP

เครื่องมือ Wi‑Fi อื่น

Portal

Bluetooth และการตรวจจับอื่น

หยุด Runtime

ควบคุมหน้าจอ

ขอภาพหน้าจอ

Status Stream

คำสั่งไฟล์

ลำดับการเชื่อมต่อที่แนะนำ