A. Yêu cầu

Để sử dụng dự án Android Studio này, bạn cần Android Studio Ladybug (2024.2) hoặc mới hơn.
Để lập trình robot bằng Blocks hoặc OnBot Java, bạn không cần Android Studio.

B. Bắt đầu

Nếu bạn mới tiếp cận robotics hoặc mới tham gia FIRST Tech Challenge, hãy xem qua hướng dẫn FTC Blocks để làm quen với cách sử dụng hệ thống điều khiển:

👉 [FTC Blocks Online Tutorial]

Ngay cả khi bạn đã là một lập trình viên Java nâng cao, cũng nên bắt đầu với hướng dẫn FTC Blocks trước, sau đó mới chuyển sang OnBot Java Tool hoặc Android Studio.

C. Tải dự án

Nếu bạn lập trình bằng Android Studio, có nhiều cách để tải repo này.
Lưu ý: Nếu bạn dùng Blocks hoặc OnBot Java Tool để lập trình robot, bạn không cần tải kho lưu trữ này.

Nếu bạn là người dùng Git, hãy clone phiên bản mới nhất của repo:

https://github.com/FIRST-Tech-Challenge/FtcRobotController.git

Hoặc, bạn có thể nhấn nút “Download Zip” trên trang chính của repo. Cách này giúp kích thước tải xuống gọn nhẹ hơn.

Bạn cũng có thể tải thư mục dự án (dưới dạng .zip hoặc .tar.gz) từ mục Downloads trên trang Releases. Trang Releases cũng có sẵn các APK đã biên dịch trước.

Sau khi tải về và giải nén (nếu cần), bạn có thể dùng Android Studio để import thư mục dự án:
“Import project (Eclipse ADT, Gradle, etc.)”.

D. Trợ giúp

1. Tài liệu và hướng dẫn người dùng

FIRST duy trì tài liệu trực tuyến với các thông tin và hướng dẫn về cách sử dụng phần mềm và hệ thống điều khiển robot FTC. Truy cập tại:

👉 [FIRST Tech Challenge Documentation]

Lưu ý: Đây là tài liệu trực tuyến luôn được cập nhật (“evergreen”), chứa thông tin mới nhất về phần mềm và hệ thống điều khiển của FTC.

2. Javadoc Reference

Tài liệu tham khảo Javadoc cho FTC SDK hiện đã có trực tuyến tại:

👉 [FTC Javadoc Documentation]

3. Diễn đàn trực tuyến

Để đặt câu hỏi kỹ thuật về Control System hoặc FTC SDK, hãy truy cập:

👉 [FIRST Tech Challenge Community]

4. Sample OpModes

Dự án này chứa nhiều ví dụ Sample OpModes (mẫu code robot). Bạn có thể copy trực tiếp vào thư mục /teamcode để dùng ngay, hoặc chỉnh sửa cho phù hợp với đội của mình.

📂 Thư mục Samples:

/FtcRobotController/src/main/java/org/firstinspires/ftc/robotcontroller/external/samples

File readme.md trong thư mục /TeamCode/src/main/java/org/firstinspires/ftc/teamcode giải thích cách đặt tên mẫu và hướng dẫn copy chúng vào dự án riêng.

Thông tin phát hành

Phiên bản 11.0 (20250827-105138)

Cải tiến mới:

• OnBotJava giờ đây có khái niệm Project (dự án). Một project là tập hợp các file liên quan.

• Có thể chọn “Example Project” từ menu “File type:”, hệ thống sẽ tự động hiển thị danh sách project.

• Khi chọn project, tất cả file liên quan sẽ hiện ở khung bên trái dưới thư mục project đó → hữu ích cho ví dụ ConceptExternalHardwareClass phụ thuộc vào RobotHardware.

• Hỗ trợ cảm biến mới: AndyMark ToF, IMU, Color.

• Ứng dụng Driver Station cảnh báo nếu WiFi bị tắt.

• Nhiều tính năng xử lý màu mới:

  • Giải mã màu ARTIFACT_GREEN và ARTIFACT_PURPLE

  • Chọn thứ tự tiền xử lý Erode và Dilate

  • Thêm chế độ hiển thị circleFit (thay thế cho boxFit)

  • Thêm ví dụ ConceptVisionColorLocator_Circle (song song với ConceptVisionColorLocator_Rectangle)
    
    

• Nút Play trong Driver Station có nền xanh, biểu tượng trắng khi:

  • Driver Station và Robot Controller cùng team number

  • Có ít nhất một gamepad kết nối

  • Đồng hồ hẹn giờ bật (trong Autonomous OpMode)
    
    

• Cập nhật thư viện AprilTag cho DECODE. Hàm getCurrentGameTagLibrary() nay trả về thẻ DECODE.

• Các thẻ AprilTag trên Obelisk không được dùng cho localization → các ví dụ chỉ sử dụng thẻ không có tên “Obelisk”.

• Cập nhật driver OctoQuad I2C hỗ trợ firmware v3.x.

• Thêm hỗ trợ odometry localizer trên phần cứng MK2.

• Hỗ trợ theo dõi vị trí encoder tuyệt đối qua nhiều vòng quay.

• Một số API driver thay đổi → cần cập nhật nhỏ cho phần mềm người dùng.

• Yêu cầu firmware v3.x. Xem hướng dẫn tại:
  OctoQuad Firmware Update Guide