NeoRace — Đường Đua ThingBot

Trò chơi đua xe robot 2 làn cho Làng Maker @ FPT Shop. Chạy trên NEO One Box, kết nối 2 ThingBot ESP32 qua USB.

Yêu cầu

• Python 3.11+
• 2 mạch ThingBot ESP32 (với firmware telemetrix)
• 6 cảm biến IR digital + 2 servo SG90
• NEO One Box hoặc Mac dev

Cài đặt

git clone <repo>
cd NeoRace
python -m venv .venv
source .venv/bin/activate
make install

Chạy

make run               # với hardware thật
make run-sim-engine    # không cần hardware (phím q/w/e + i/o/p)

Test

make test              # unit tests
make test-integration  # E2E scenarios
make lint              # ruff + mypy

Cấu trúc thư mục

• src/neorace/ — code app
• tests/ — pytest unit + integration
• tools/ — simulator + hardware verification
• config/ — pin mapping
• docs/ — hướng dẫn vận hành + design spec