Сенсорний світлодіод#

Вступ #

Світлодіодний індикатор VEX IQ Touch — це одночасно індикатор і кнопка. Він може світитися різними кольорами, щоб надати зворотний зв’язок, наприклад, сигналізуючи про готовність робота, показуючи вибраний режим або збігаючись із кольором, виявленим іншим датчиком, а також він може виявляти дотик, дозволяючи запускати робота або змінювати його поведінку одним дотиком.

На цій сторінці як приклад назви сенсорного світлодіода використовується touchled_1 За потреби замініть її власною налаштованою назвою.

Нижче наведено список усіх методів:

Дії — Взаємодія зі світлодіодним індикатором Touch.

pressed — Реєструє функцію, яка викликається при натисканні сенсорного світлодіода.
released — Реєструє функцію, яка викликається при відпусканні сенсорного світлодіода.
on — Вмикає сенсорний світлодіод.
off — Вимикає сенсорний світлодіод.
toggle — Вмикає або вимикає сенсорний світлодіод.

Мутатори — змінюють кольори, яскравість та налаштування сенсорного світлодіода.

set_color — Встановлює колір світлодіода Touch.
set_fade — Встановлює швидкість переходу кольорів один в один.
set_brightness — Встановлює яскравість сенсорного світлодіода.
set_blink — По черзі вмикати та вимикати сенсорний світлодіод необмежений час.

Геттери — повертають дані з сенсорного світлодіода.

pressing — Повертає, чи натискається сенсорний світлодіод.
installed — Повертає, чи підключено сенсорний світлодіод до мозку.

Конструктори — ініціалізують та налаштовують сенсорний світлодіод вручну.

Touchled — Створення сенсорного світлодіода.

Дії #

pressed #

pressed реєструє функцію, яка викликається при натисканні сенсорного світлодіода.

Usage:
touchled_1.pressed(callback, arg)

Параметри	Опис
`callback`	Функція function, яку попередньо визначено для виконання при натисканні сенсорного світлодіода.
`arg`	Необов’язково. Кортеж tuple, що містить аргументи для передачі функції зворотного виклику. Див. Функції з параметрами для отримання додаткової інформації.

# Turn blue while the Touch LED is pressed
def light_blue():
    touchled_1.set_color(Color.BLUE)

touchled_1.pressed(light_blue)

released #

released реєструє функцію, яка викликається при відпусканні сенсорного світлодіода.

Usage:
touchled_1.released(callback, arg)

Параметри	Опис
`callback`	Функція function, яку попередньо визначено для виконання при відпусканні світлодіода Touch.
`arg`	Необов’язково. Кортеж tuple, що містить аргументи для передачі функції зворотного виклику. Див. Функції з параметрами для отримання додаткової інформації.

# Turn red when the Touch LED is released
def light_red():
    touchled_1.set_color(Color.RED)

touchled_1.released(light_red)

on #

on вмикає сенсорний світлодіод, встановлюючи його яскравість на 100%.

Usage:
touchled_1.on(value)

Параметри	Опис
`value`	Необов’язково. Встановлює колір світлодіода на: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (за замовчуванням) `Color.YELLOW` `Color.ORANGE` `Color.PURPLE` `Color.RED_VIOLET` `Color.VIOLET` `Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` `Color.RED_ORANGE` Ви також можете вказати власний колір.

Параметри

Опис

value

Необов’язково. Встановлює колір світлодіода на:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE (за замовчуванням)
Color.YELLOW
Color.ORANGE
Color.PURPLE
Color.RED_VIOLET
Color.VIOLET
Color.BLUE_VIOLET
Color.BLUE_GREEN
Color.YELLOW_GREEN
Color.YELLOW_ORANGE
Color.RED_ORANGE

Ви також можете вказати власний колір.

# Turn green when the robot is moving
touchled_1.on(Color.GREEN)
drivetrain.drive_for(FORWARD, 5)
touchled_1.off()

off #

off вимикає сенсорний світлодіод, встановлюючи його яскравість на 0%.

Usage:
touchled_1.off()

Параметри	Опис
	Цей метод не має параметрів.

# Turn off Touch LED when movement is over
touchled_1.on(Color.GREEN)
drivetrain.drive_for(FORWARD, 5)
touchled_1.off()

toggle #

toggle вмикає або вимикає сенсорний світлодіод. Якщо світлодіод увімкнено, toggle встановлює його яскравість на 0%, вимикаючи його. Якщо світлодіод вимкнено, toggle встановлює його яскравість на 100%, вмикаючи його.

Usage:
touchled_1.toggle()

Параметри	Опис
	Цей метод не має параметрів.

# Turn the Touch LED off and on
touchled_1.set_color(Color.RED)
while True:
    touchled_1.toggle()
    wait(0.5,SECONDS)

Мутатори #

set_color #

set_color встановлює колір сенсорного світлодіода. Якщо сенсорний світлодіод ще не ввімкнено, коли використовується цей метод, яскравість буде встановлено на 100%, щоб увімкнути сенсорний світлодіод.

Usage:
touchled_1.set_color(color)

Параметри	Опис
`color`	Необов’язково. Встановлює колір світлодіода на: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (за замовчуванням) `Color.YELLOW` `Color.ORANGE` `Color.PURPLE` `Color.RED_VIOLET` `Color.VIOLET` `Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` `Color.RED_ORANGE` Якщо не вказано, `set_color` увімкне сенсорний світлодіод з попередньо встановленим кольором. Ви також можете вказати власний колір.

Параметри

Опис

color

Необов’язково. Встановлює колір світлодіода на:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE (за замовчуванням)
Color.YELLOW
Color.ORANGE
Color.PURPLE
Color.RED_VIOLET
Color.VIOLET
Color.BLUE_VIOLET
Color.BLUE_GREEN
Color.YELLOW_GREEN
Color.YELLOW_ORANGE
Color.RED_ORANGE

Якщо не вказано, set_color увімкне сенсорний світлодіод з попередньо встановленим кольором.
Ви також можете вказати власний колір.

# Change colors between blue and green
while True:
    touchled_1.set_color(Color.BLUE)
    wait(0.5, SECONDS)
    touchled_1.set_color(Color.GREEN)
    wait(0.5, SECONDS)

set_fade #

set_fade змінює спосіб переходу сенсорного світлодіода до нових кольорів.

Usage:
touchled_1.set_fade(type)

Параметри	Опис
`type`	Як швидко колір переходить від одного до наступного: `FadeType.FAST` — Кольори переходитимуть швидко. `FadeType.OFF` — Кольори переходитимуть миттєво. `FadeType.SLOW` — Кольори переходитимуть повільно.

Параметри

Опис

type

Як швидко колір переходить від одного до наступного:

FadeType.FAST — Кольори переходитимуть швидко.
FadeType.OFF — Кольори переходитимуть миттєво.
FadeType.SLOW — Кольори переходитимуть повільно.

# No fade to red, then slow fade to purple
touchled_1.set_fade(FadeType.OFF)
touchled_1.set_color(Color.RED)
wait(2, SECONDS)
touchled_1.set_fade(FadeType.SLOW)
touchled_1.set_color(Color.PURPLE)

set_brightness #

set_brightness встановлює яскравість сенсорного світлодіода.

Usage:
touchled_1.set_brightness(brightness)

Параметри	Опис
`brightness`	Яскравість сенсорного світлодіода встановлюється цілим числом від 0% до 100%.

# Show green at different brightness levels
touchled_1.set_color(Color.GREEN)
wait(1, SECONDS)
touchled_1.set_brightness(10)
wait(1, SECONDS)
touchled_1.set_brightness(100)

set_blink #

set_blink багаторазово блимає світлодіод Touch у послідовності вмикання та вимикання.

Примітка: Виклик off не зупинить миготіння. Щоб зупинити миготіння, встановіть яскравість світлодіода на 0 за допомогою set_brightness.

Usage:
set_blink(color, ontime, offtime)

Параметри	Опис
`color`	Встановлює колір сенсорного світлодіода на: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` `Color.YELLOW` `Color.ORANGE` `Color.PURPLE` `Color.RED_VIOLET` `Color.VIOLET` `Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` `Color.RED_ORANGE` Ви також можете вказати власний колір.
`ontime`	Тривалість кожного миготіння світлодіода в секундах. За замовчуванням — 0,25 секунди.
`offtime`	Тривалість кожного миготіння світлодіода (у секундах). За замовчуванням — 0,25 секунди.

Параметри

Опис

color

Встановлює колір сенсорного світлодіода на:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE
Color.YELLOW
Color.ORANGE
Color.PURPLE
Color.RED_VIOLET
Color.VIOLET
Color.BLUE_VIOLET
Color.BLUE_GREEN
Color.YELLOW_GREEN
Color.YELLOW_ORANGE
Color.RED_ORANGE

Ви також можете вказати власний колір.

ontime

Тривалість кожного миготіння світлодіода в секундах. За замовчуванням — 0,25 секунди.

offtime

Тривалість кожного миготіння світлодіода (у секундах). За замовчуванням — 0,25 секунди.

# Blink green for 2 seconds then stop
touchled_1.set_blink(Color.GREEN, 0.5, 0.5)
wait(2, SECONDS)
touchled_1.set_brightness(0)

Геттери #

pressing #

pressing повертає ціле число, яке вказує, чи натискається на даний момент сенсорний світлодіод.

1 — Натискається сенсорний світлодіод.
0 — Сенсорний світлодіод не натискається.

Usage:
touchled_1.pressing()

Параметри	Опис
	Цей метод не має параметрів.

# Turn TouchLED green when touched
while True:
    if touchled_1.pressing():
        touchled_1.set_color(Color.GREEN)
    else:
        touchled_1.set_color(Color.RED)
    wait(50, MSEC)

installed #

installed повертає логічне значення, яке вказує, чи підключено світлодіод Touch до Brain.

True — Світлодіод Touch підключено до мозку.
False — Світлодіод Touch не підключено до Brain.

Usage:
touchled_1.installed()

Параметри	Опис
	Цей метод не має параметрів.

Конструктори #

Конструктори використовуються для ручного створення об’єктів Touchled , які необхідні для налаштування Touch LED поза VEX-кодом.

Touchled #

Touchled створює сенсорний світлодіод.

Usage:
touchled_1 = Touchled(smartport)

Параметр	Опис
`smartport`	Розумний порт, до якого підключено сенсорний світлодіодний індикатор, записується як PORTx, де x – номер порту.

# Create a Touchled in Port 1
touchled_1 = Touchled(Ports.PORT1)