Bộ điều khiển#

Giới thiệu#

Bộ điều khiển VEX EXP có các nút bấm và hai cần điều khiển. Các phương thức điều khiển có thể được sử dụng để kiểm tra các lần nhấn nút, đọc chuyển động của cần điều khiển, bật hoặc tắt các hành động điều khiển đã được cấu hình, hoặc chạy các chức năng khi các sự kiện điều khiển xảy ra.

Các hành động điều khiển đã cấu hình là các hành vi điều khiển được thiết lập trong menu Thiết bị. Sử dụng remote_control_code_enabled để tạm thời bật hoặc tắt các hành động đã cấu hình đó trong quá trình thực hiện dự án.

Trang này sử dụng controller làm ví dụ về tên bộ điều khiển. Hãy thay thế bằng tên đã cấu hình của riêng bạn nếu cần.

Dưới đây là danh sách tất cả các phương pháp hiện có:

Hành động — Bật hoặc tắt các hành động điều khiển đã được cấu hình.

  • remote_control_code_enabled — Cho phép hoặc vô hiệu hóa các hành động của bộ điều khiển được cấu hình trong menu Thiết bị.

Getters — Đọc trạng thái nút bấm và vị trí cần điều khiển.

  • .pressing — Trả về liệu nút được chỉ định có đang được nhấn hay không.

  • .position — Trả về vị trí của trục cần điều khiển được chỉ định.

Hàm gọi lại — Thực thi các hàm khi dữ liệu đầu vào từ bộ điều khiển thay đổi.

  • .pressed — Chạy một hàm khi một nút được chỉ định được nhấn.

  • .released — Chạy một hàm khi nút được chỉ định được nhả ra.

  • .changed — Chạy một hàm khi vị trí của cần điều khiển thay đổi dọc theo một trục được chỉ định.

Hàm khởi tạo — Tự tạo đối tượng Controller.

  • Controller — Tạo một đối tượng Bộ điều khiển.

Hoạt động#

remote_control_code_enabled#

remote_control_code_enabled là một biến cho phép bật hoặc tắt các hành động của bộ điều khiển được cấu hình trong menu Thiết bị. Các hành động được cấu hình của bộ điều khiển được bật theo mặc định.

Usage:
remote_control_code_enabled = state

Giá trị

Sự miêu tả

True

Cho phép thực hiện các hành động được cấu hình trên bộ điều khiển.

False

Vô hiệu hóa các hành động được cấu hình trên bộ điều khiển.

# Drive forward or backward using the left joystick
remote_control_code_enabled = False

while True:
    if controller.axis3.position() > 0:
        drivetrain.drive(FORWARD)
    elif controller.axis3.position() < 0:
        drivetrain.drive(REVERSE)
    # Press A to use controller configured actions again
    elif controller.buttonA.pressing():
        break
    else:
        drivetrain.stop()

    wait(20, MSEC)

remote_control_code_enabled = True

Người nhận#

.pressing#

.pressing trả về trạng thái liệu một nút cụ thể trên bộ điều khiển có đang được nhấn hay không. Phương thức này phải được gọi trên một đối tượng nút cụ thể, chẳng hạn như controller.buttonA.

  • True — Nút được chỉ định đang được nhấn.

  • False — Nút được chỉ định không được nhấn.

Cách sử dụng:
Một trong các đối tượng nút có sẵn có thể được sử dụng với phương thức này:

Mặt trước và mặt trên của tay cầm EXP với các cần điều khiển, nút mũi tên và nút chức năng được tô sáng màu vàng. Trên bề mặt tay cầm có hai cần điều khiển ở bên trái và bên phải, với các nút mũi tên lên và xuống ở bên trái và các nút A và B ở bên phải. Trên đỉnh tay cầm có các nút L1 và L2 ở bên trái và R1 và R2 ở bên phải.

Cái nút

Yêu cầu

buttonA

controller.buttonA.pressing() — Nút A

buttonB

controller.buttonB.pressing() — Nút B

buttonDown

controller.buttonDown.pressing() — Nút Xuống

buttonUp

controller.buttonUp.pressing() — Nút Lên

buttonL1

controller.buttonL1.pressing() — Nút L1

buttonL2

controller.buttonL2.pressing() — Nút L2

buttonL3

controller.buttonL3.pressing() — Nút L3

buttonR1

controller.buttonR1.pressing() — Nút R1

buttonR2

controller.buttonR2.pressing() — Nút R2

buttonR3

controller.buttonR3.pressing() — Nút R3

Thông số

Sự miêu tả

Phương pháp này không có tham số.

# Turn right while L1 is pressed
while True:
    if controller.buttonL1.pressing():
        drivetrain.turn(RIGHT)
    else:
        drivetrain.stop()

    wait(20, MSEC)

.position#

.position trả về vị trí của trục cần điều khiển dưới dạng một số từ -100 đến 100.

Phương thức này phải được gọi trên một đối tượng trục cụ thể, chẳng hạn như controller.axis1.

Cách sử dụng:
Một trong các đối tượng trục có sẵn có thể được sử dụng với phương pháp này:

Mặt trước của bộ điều khiển EXP với các số trục cần điều khiển được đánh dấu màu đỏ. Trên bề mặt của bộ điều khiển, cần điều khiển bên trái được ghi nhãn là Trục 4 cho chuyển động trái và phải và Trục 3 cho chuyển động lên và xuống, trong khi cần điều khiển bên phải được ghi nhãn là Trục 1 cho chuyển động trái và phải và Trục 2 cho chuyển động lên và xuống.

Trục

Yêu cầu

axis1

controller.axis1.position() — Trục ngang của cần điều khiển bên phải

axis2

controller.axis2.position() — Trục dọc của cần điều khiển bên phải

axis3

controller.axis3.position() — Trục dọc của cần điều khiển bên trái

axis4

controller.axis4.position() — Trục ngang của cần điều khiển bên trái

Thông số

Sự miêu tả

Phương pháp này không có tham số.

# Turn with the left joystick
remote_control_code_enabled = False

while True:
    if controller.axis4.position() > 10:
        drivetrain.turn(RIGHT)
    elif controller.axis4.position() < -10:
        drivetrain.turn(LEFT)
    else:
        drivetrain.stop()

    wait(20, MSEC)

Cuộc gọi lại#

.pressed#

.pressed sẽ chạy một hàm khi nút được chỉ định được nhấn. Sau khi được sử dụng, hàm này sẽ tự động chạy mỗi khi nút đó được nhấn.

Cách sử dụng:
Một trong các đối tượng nút có sẵn có thể được sử dụng với phương thức này:

Mặt trước và mặt trên của tay cầm EXP với các cần điều khiển, nút mũi tên và nút chức năng được tô sáng màu vàng. Trên bề mặt tay cầm có hai cần điều khiển ở bên trái và bên phải, với các nút mũi tên lên và xuống ở bên trái và các nút A và B ở bên phải. Trên đỉnh tay cầm có các nút L1 và L2 ở bên trái và R1 và R2 ở bên phải.

Cái nút

Yêu cầu

buttonA

controller.buttonA.pressed(callback, arg) — Nút A

buttonB

controller.buttonB.pressed(callback, arg) — Nút B

buttonDown

controller.buttonDown.pressed(callback, arg) — Nút Xuống

buttonUp

controller.buttonUp.pressed(callback, arg) — Nút Lên

buttonL1

controller.buttonL1.pressed(callback, arg) — Nút L1

buttonL2

controller.buttonL2.pressed(callback, arg) — Nút L2

buttonL3

controller.buttonL3.pressed(callback, arg) — Nút L3

buttonR1

controller.buttonR1.pressed(callback, arg) — Nút R1

buttonR2

controller.buttonR2.pressed(callback, arg) — Nút R2

buttonR3

controller.buttonR3.pressed(callback, arg) — Nút R3

Tham số

Sự miêu tả

callback

Một hàm được định nghĩa trước đó để chạy mỗi khi nút được chỉ định được nhấn.

arg

Tùy chọn. Một bộ chứa các đối số để truyền cho hàm gọi lại. Xem Sử dụng Sự kiện với Tham số để biết thêm thông tin.

# Drive forward when R1 is pressed
def drive_forward():
    drivetrain.drive_for(FORWARD, 200, MM)

controller.buttonR1.pressed(drive_forward)

.released#

.released sẽ chạy một hàm khi nút được chỉ định được nhả ra. Sau khi được sử dụng, hàm này sẽ tự động chạy mỗi khi nút đó được nhả ra.

Cách sử dụng:
Một trong các đối tượng nút có sẵn có thể được sử dụng với phương thức này:

Mặt trước và mặt trên của tay cầm EXP với các cần điều khiển, nút mũi tên và nút chức năng được tô sáng màu vàng. Trên bề mặt tay cầm có hai cần điều khiển ở bên trái và bên phải, với các nút mũi tên lên và xuống ở bên trái và các nút A và B ở bên phải. Trên đỉnh tay cầm có các nút L1 và L2 ở bên trái và R1 và R2 ở bên phải.

Cái nút

Yêu cầu

buttonA

controller.buttonA.released(callback, arg) — Nút A

buttonB

controller.buttonB.released(callback, arg) — Nút B

buttonDown

controller.buttonDown.released(callback, arg) — Nút Xuống

buttonUp

controller.buttonUp.released(callback, arg) — Nút Lên

buttonL1

controller.buttonL1.released(callback, arg) — Nút L1

buttonL2

controller.buttonL2.released(callback, arg) — Nút L2

buttonL3

controller.buttonL3.released(callback, arg) — Nút L3

buttonR1

controller.buttonR1.released(callback, arg) — Nút R1

buttonR2

controller.buttonR2.released(callback, arg) — Nút R2

buttonR3

controller.buttonR3.released(callback, arg) — Nút R3

Tham số

Sự miêu tả

callback

Một hàm được định nghĩa trước đó để chạy mỗi khi nút được chỉ định được nhả ra.

arg

Tùy chọn. Một bộ chứa các đối số để truyền cho hàm gọi lại. Xem Sử dụng Sự kiện với Tham số để biết thêm thông tin.

# Stop driving when R1 is released
def stop_driving():
    drivetrain.stop()

controller.buttonR1.released(stop_driving)

.changed#

.changed sẽ chạy một hàm khi vị trí của cần điều khiển thay đổi dọc theo trục được chỉ định. Sau khi được sử dụng, hàm này sẽ tự động chạy mỗi khi vị trí của cần điều khiển thay đổi dọc theo trục đó.

Cách sử dụng:
Một trong các đối tượng trục có sẵn có thể được sử dụng với phương pháp này:

Mặt trước của bộ điều khiển EXP với các số trục cần điều khiển được đánh dấu màu đỏ. Trên bề mặt của bộ điều khiển, cần điều khiển bên trái được ghi nhãn là Trục 4 cho chuyển động trái và phải và Trục 3 cho chuyển động lên và xuống, trong khi cần điều khiển bên phải được ghi nhãn là Trục 1 cho chuyển động trái và phải và Trục 2 cho chuyển động lên và xuống.

Trục

Yêu cầu

axis1

controller.axis1.changed(callback, arg) — Trục ngang của cần điều khiển bên phải

axis2

controller.axis2.changed(callback, arg) — Trục dọc của cần điều khiển bên phải

axis3

controller.axis3.changed(callback, arg) — Trục dọc của cần điều khiển bên trái

axis4

controller.axis4.changed(callback, arg) — Trục ngang của cần điều khiển bên trái

Tham số

Sự miêu tả

callback

Một hàm được định nghĩa trước đó để chạy mỗi khi vị trí của cần điều khiển thay đổi dọc theo trục được chỉ định.

arg

Tùy chọn. Một bộ chứa các đối số để truyền cho hàm gọi lại. Xem Sử dụng Sự kiện với Tham số để biết thêm thông tin.

# Play a sound when the left joystick moves
def beep():
    brain.play_sound(SoundType.TADA)

controller.axis3.changed(beep)

Các hàm tạo#

Controller#

Lệnh Controller tạo một đối tượng Controller. Việc tạo thủ công đối tượng Controller chỉ cần thiết khi cấu hình bộ điều khiển bên ngoài VEXcode.

Usage:
Controller()

Thông số

Sự miêu tả

Hàm tạo này không có tham số.

# Create a Controller object
my_controller = Controller()