คู่มือ
📡

ตั้งค่า Hardware Tracking

Pro

ติดตั้ง anchor + beacon สำหรับเก็บ heatmap, ระยะวิ่ง, และความเร็วสูงสุดของผู้เล่นแบบ real-time

อุปกรณ์ที่ต้องใช้

🟢

Heltec LoRa32 V3

4 anchor + 1 hub receiver

5 ตัว
🔋

ถ่าน 14500 + เคส

ใส่ใน anchor

5 ชุด
🟡

BLE Beacon (iBeacon/Holyiot)

ติดที่แขนหรือถุงเท้า

1 ต่อผู้เล่น
🖥️

Raspberry Pi 5

hub server พร้อม power bank

1 ตัว
🔌

สาย USB-C

ต่อ hub receiver → RPi

1 เส้น

ติดตั้งครั้งแรก (ทำครั้งเดียว)

  1. 📦
    01

    Flash Raspberry Pi OS

    ใช้ Raspberry Pi Imager flash Raspberry Pi OS Lite (64-bit) ลง microSD แล้วเปิดใช้ SSH และใส่ชื่อ Wi-Fi เบื้องต้นในตัว Imager ถ้ามี

  2. 📋
    02

    Copy ไฟล์ hub ลง RPi

    SSH เข้า RPi แล้วรัน: git clone https://github.com/your-org/mvpitch-hub /tmp/hub หรือ copy ไฟล์จาก firmware/rpi/ ไปไว้ที่ RPi

    scp -r firmware/rpi/ pi@raspberrypi.local:/tmp/hub/
  3. ⚙️
    03

    รัน installer

    SSH เข้า RPi แล้วรัน install script ครั้งเดียว — ใช้เวลาประมาณ 5 นาที

    sudo bash /tmp/hub/setup/install.sh
  4. 🔑
    04

    ใส่ Hub Token

    ไปที่ Profile ใน MVPitch app → กด "Hub Token" → Generate → Copy token แล้วไปที่ /boot/firmware/mvpitch.env บน RPi แล้วใส่ token หรือทำผ่าน config portal ในขั้นถัดไป

Config WiFi + Token ผ่าน Hotspot

ถ้า RPi ไม่ได้ต่อ WiFi มันจะเปิด hotspot ให้ config ผ่าน browser แทน

  1. 01เปิด RPi — ถ้ายังไม่ได้บันทึก WiFi ไว้ มันจะเปิด hotspot ชื่อ "MVPitch-Setup" ขึ้นมาอัตโนมัติ
  2. 02เชื่อมต่อมือถือหรือ laptop เข้า WiFi "MVPitch-Setup" (รหัส: mvpitch1)
  3. 03เปิด browser แล้วไปที่ 192.168.4.1
  4. 04กรอก WiFi ของสนาม (หรือ Personal Hotspot จากมือถือ) + Hub Token → กด "บันทึก & Restart"
  5. 05RPi จะ reboot และเชื่อมต่อ WiFi อัตโนมัติจากนี้ไป
📱

192.168.4.1

เปิดใน browser หลังเชื่อมต่อ MVPitch-Setup

เปลี่ยน WiFi ทีหลัง

🌐

ผ่าน WiFi (แนะนำ)

ถ้า Hub ต่อ WiFi อยู่แล้ว → เปิด browser แล้วไปที่ http://[IP ของ Hub]:8080 แก้ได้เลย ไม่ต้อง reboot

📶

ผ่าน Hotspot

ล้าง WiFi ออกจาก config ผ่าน 192.168.4.1 → กด "ลืม WiFi" → Hub จะ reboot และเปิด hotspot ให้ config ใหม่

🔄

WiFi หายไปเอง

ถ้า Hub boot ขึ้นมาแล้วหา WiFi ไม่เจอ (เช่น เปลี่ยนเราเตอร์) → auto เปิด hotspot ให้ config ใหม่อัตโนมัติ

ตั้งค่าสนามก่อนแมตช์

  1. 📐
    01

    วาง Anchor 4 มุม

    วาง Heltec anchor ที่มุมสนาม 4 มุม ให้ยื่นออกนอกสนามนิดหน่อย (ประมาณ 1 เมตร) เปิดสวิตช์ทุกตัว LED จะกะพริบขณะ scan หา Hub

  2. 📡
    02

    วาง Hub Receiver

    วาง Heltec Hub Receiver ข้าง sideline ใกล้ RPi ต่อสาย USB-C เข้า RPi แล้วเปิด RPi

  3. ⏱️
    03

    รอ Pairing

    ระบบจะจับคู่ anchor อัตโนมัติภายใน 30 วินาที Hub จะ broadcast slot ให้ anchor แต่ละตัว ไม่ต้องกดอะไร

  4. 📏
    04

    Auto-calibrate

    หลัง pairing เสร็จ Hub จะรัน ranging ระหว่าง anchor ทุกคู่เพื่อสร้าง 2D coordinate ของสนาม ใช้เวลาประมาณ 1 นาที

ผังการวาง Anchor

A1 ─────────────────── A2
│       สนาม           │
│                       │
│                       │
A4 ─────────────────── A3
══════════════════════════
   Hub + RPi (sideline)

A1–A4 = Heltec anchor · Hub วางข้าง sideline (ไม่ใช่มุมสนาม)

การใช้งานแต่ละแมตช์

  1. 01เปิด Match ที่ต้องการ Tracking
  2. 02กด "กำหนด Beacon ผู้เล่น" → จับคู่ beacon MAC กับผู้เล่นแต่ละคน
  3. 03กด "เริ่ม Tracking" — Hub จะเริ่มส่ง position ทุก 200ms
  4. 04ผู้เล่นใส่ beacon ที่แขนหรือถุงเท้า
  5. 05หลังเกมจบ กด "หยุด Tracking" — สถิติจะแสดงทันที

เคล็ดลับ

  • Anchor ต้องมีแบตเตอรี่เต็มก่อนลงสนาม ชาร์จทาง USB-C
  • ถ้า anchor โดนบอลเตะขยับ ระบบจะแจ้งเตือนใน match → กด Recalibrate
  • Beacon ควรอยู่ห่างจาก anchor ไม่เกิน 50 เมตร
  • ความแม่นยำ ±3–5 เมตร เพียงพอสำหรับ heatmap และสถิติ sprint
  • ต้องการ pair anchor ใหม่ → ไปที่หน้า Group → กด "Reset Anchor Pairing" ใน Hub section — ไม่ต้องแตะ hardware
  • ผู้เล่นที่อยู่นอกสนาม (แถวเบนช์) จะ mark ว่า on_bench โดยอัตโนมัติ ไม่นับ distance