> For the complete documentation index, see [llms.txt](https://help.trikset.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.trikset.com/ev3/blocks.md).

# Блоки LEGO EV3

Специализированные блоки для LEGO EV3 делятся на несколько категорий:

1. [Действия](/ev3/blocks.md#bloki-deistviya) — блоки, выполняющие какое-либо действие на роботе: включение моторов, проигрывание звука и т.д.
2. [Ожидания](/ev3/blocks.md#bloki-ozhidaniya) — блоки, ждущие наступления какого-либо события: определённых показаний датчиков, нажатия на кнопку и т.д.
3. [Рисования на дисплее](/ev3/blocks.md#risovanie-na-displee) — блоки, используемые для вывода графики и текста на экран.
4. [Line Leader](/ev3/blocks.md#line-leader) — блоки для продвинутого датчика «Line Leader».

&#x20;Блоки, доступные для всех платформ см. в статье «[Общие блоки](/studio/programming-visual/blocks.md)».

## Блоки действия

| Вид                                                                 | Название                                                                     | Описание                                                                                                                                                                                                                       |
| ------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <img src="/files/-M56ZRIGIyABvvSEiPaP" alt="" data-size="original"> | [Отправить сообщение в задачу](/ev3/blocks.md#otpravit-soobshenie-v-zadachu) | Отправляет данное сообщение в параллельную задачу с заданным идентификатором (идентификатор должен быть указан при создании задачи в блоке «[Параллельные задачи](/studio/programming-visual/blocks.md#parallelnye-zadachi)»). |
| <img src="/files/-M56ZpP-xMkrCJzlWy2g" alt="" data-size="original"> | [Гудок](/ev3/blocks.md#gudok)                                                | Проиграть на роботе звук с фиксированной частотой.                                                                                                                                                                             |
| <img src="/files/-M56_YY9Mb1unPVpNTP-" alt="" data-size="original"> | [Играть звук](/ev3/blocks.md#igrat-zvuk)                                     | Проиграть на роботе звук с заданной частотой и длительностью.                                                                                                                                                                  |
| <img src="/files/-M56_oRM69Bvm9OffV6R" alt="" data-size="original"> | [Моторы вперед](/ev3/blocks.md#motory-vpered)                                | Включить моторы по заданным портам с заданной мощностью.                                                                                                                                                                       |
| <img src="/files/-M56aBmIClnllm_-6VC5" alt="" data-size="original"> | [Моторы назад](/ev3/blocks.md#motory-nazad)                                  | Включить моторы в режиме реверса по заданным портам с заданной мощностью.                                                                                                                                                      |
| <img src="/files/-M56aNWEcLNeAGndA_Jc" alt="" data-size="original"> | [Моторы стоп](/ev3/blocks.md#motory-stop)                                    | Выключить моторы по заданным портам.                                                                                                                                                                                           |
| <img src="/files/-M56adQRXqQQiwHAf6jp" alt="" data-size="original"> | [Сбросить показания энкодера](/ev3/blocks.md#sbrosit-pokazaniya-enkodera)    | Сбросить показания количества оборотов моторов.                                                                                                                                                                                |
| <img src="/files/-M56b4AQB2RenK0T6IEa" alt="" data-size="original"> | [Светодиод](/ev3/blocks.md#svetodiod)                                        | Установить цвет светодиода на передней панели робота.                                                                                                                                                                          |
| <img src="/files/-M56b_N79x_eDyefstGU" alt="" data-size="original"> | [Отправить письмо роботу](/ev3/blocks.md#otpravit-pismo-robotu)              | Отправить письмо другому роботу.                                                                                                                                                                                               |
| <img src="/files/-M56gPpHxUzrJvJjFZOh" alt="" data-size="original"> | [Калибровка гироскопа](/ev3/blocks.md#kalibrovka-giroskopa)                  | Устанавливает гироскоп в 0 в текущей позиции.                                                                                                                                                                                  |
| <img src="/files/-M56g_6pugsURUfZTlmq" alt="" data-size="original"> | [Начать калибровку компаса](/ev3/blocks.md#nachat-kalibrovku-kompasa)        | Начинает калибровку компаса программно.                                                                                                                                                                                        |
| <img src="/files/-M56gch1iKoUi44y4WgY" alt="" data-size="original"> | [Закончить калибровку компаса](/ev3/blocks.md#zakonchit-kalibrovku-kompasa)  | Заканчивает калибровку компаса.                                                                                                                                                                                                |
| <img src="/files/-M56h0cVvMcI0yI7Emrw" alt="" data-size="original"> | [Считать цвета в переменные](/ev3/blocks.md#schitat-cveta-v-peremennye)      | Читать RGB в переменной.                                                                                                                                                                                                       |

### Отправить сообщение в задачу

![Отправить сообщение в задачу](/files/-M575t7n3wL8LN_Wd1-v)

Отправляет данное сообщение в параллельную задачу с заданным идентификатором (идентификатор должен быть указан при создании задачи в блоке «[Параллельные задачи](/studio/programming-visual/blocks.md#parallelnye-zadachi)»).

В качестве сообщения может быть любое выражение.

### Гудок

![Гудок](/files/-M5761MdnQM5kzx69D6i)

Проиграть на роботе звук с фиксированной частотой.

Параметры:

1. &#x20;Ждать ли завершения проигрывания звука или сразу же перейти к следующему блоку. Допустимые значения — «истина», «ложь».
2. &#x20;Громкость воспроизведения.

### Играть звук

![Играть звук](/files/-M5767JFAJMBQYqnOpQK)

Проиграть на роботе звук с заданной частотой и длительностью. Аналогичен блоку «[Гудок](/ev3/blocks.md#gudok)», но позволяет также задавать параметры звука.

Параметры:

* &#x20;Частота (Гц).
* &#x20;Длительность (мс).
* &#x20;Ждать ли завершения проигрывания звука или сразу же перейти к следующему блоку. Допустимые значения — истина, ложь.
* &#x20;Громкость воспроизведения (от 0 до 100%).

### **Моторы вперед**

![Моторы вперед](/files/-M576Hfx-IJxgD_yOdxh)

Включить моторы по заданным портам с заданной мощностью. Порты задаются буквами A, B или C, разделенными запятыми.

Мощность задается в процентах числом от -100 до 100, если задано отрицательное значение, мотор включается в режиме реверса.

Моторы имеют разные режимы работы: режим торможения и режим скольжения (отображаемые красным или зелёным прямоугольником на блоке соответственно). Режимы влияют на то, как двигатель отрабатывает команду — режим торможения стопорит двигатель при отключении, режим скольжения позволяет двигателю прокручиваться по инерции.

### **Моторы назад**

![Моторы назад](/files/-M576MqpspZH-nKKM25H)

Включить моторы в режиме реверса по заданным портам с заданной мощностью. Параметры аналогичны параметрам блока «[Моторы вперёд](/ev3/blocks.md#motory-vpered)».

### **Моторы стоп**

![Моторы стоп](/files/-M577jU7Z5R3i1Afe6C7)

Выключить моторы по заданным портам.

### **Сбросить показания энкодера**

![Сбросить показания энкодера](/files/-M577nnYIL5HkD794GIF)

Сбросить показания количества оборотов моторов.

### **Светодиод**

![Светодиод](/files/-M57D5baj--9ZyA1As9J)

Установить цвет светодиода на передней панели робота.

### **Отправить письмо роботу**

![Отправить письмо роботу](/files/-M57DJBEXSV9tDRyaLqV)

Отправить письмо другому роботу. Если имя получателя не заполнено, сообщение будет отослано всем соединенным роботам.

### Калибровка гироскопа

![Калибровка гироскопа](/files/-M57EwOxXexLOsPZRo1V)

Устанавливает гироскоп в 0 в текущей позиции.

### Начать калибровку компаса

![Начать калибровку компаса](/files/-M57DyHldjpCofUU0VaC)

Начинает калибровку компаса программно.\
\
Чтобы откалибровать компас, робот должен повернуться на месте больше чем на 540° в одну, а затем в обратную сторону. После поворотов необходимо добавить блок «[Закончить калибровку компаса](/ev3/blocks.md#zakonchit-kalibrovku-kompasa)».

### Закончить калибровку компаса

![Закончить калибровку компаса](/files/-M57E3ooGPPinlUQhxZK)

Заканчивает калибровку компаса. Результат калибровки возвращается в переменной. Ненулевой результат означает успешную калибровку.

### Считать цвета в переменные

![Считать цвета в переменные](/files/-M57E7JM9yOozgi6_Bp4)

Читать RGB в переменной.

## Блоки ожидания

| Вид                                                                 | Название                                                                                    | Описание                                                                                                                                  |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="/files/-M56n4MuW-BCvqWswTTK" alt="" data-size="original"> | [Получить сообщение из другой задачи](/ev3/blocks.md#poluchit-soobshenie-iz-drugoi-zadachi) | Ждать получения сообщения из другой параллельной задачи.                                                                                  |
| <img src="/files/-M56lmpH0qhorUUuyodd" alt="" data-size="original"> | [Ждать датчик касания](/ev3/blocks.md#zhdat-datchik-kasaniya)                               | Ждать, пока не сработает датчик касания.                                                                                                  |
| <img src="/files/-M56lsyq0qWiZpZ-zRuJ" alt="" data-size="original"> | [Ждать энкодер](/ev3/blocks.md#zhdat-enkoder)                                               | Ждать, пока показания счетчика количества оборотов на заданном моторе не достигнут указанного в значении параметра «Предел оборотов».     |
| <img src="/files/-M56m-m_JXOkH3oo3KHE" alt="" data-size="original"> | [Ждать цвет](/ev3/blocks.md#zhdat-cvet)                                                     | Ждать, пока сенсор цвета в режиме распознавания цветов не вернет указанный цвет.                                                          |
| <img src="/files/-M56m65AoBcGfoo4wr6Y" alt="" data-size="original"> | [Ждать интенсивность цвета](/ev3/blocks.md#zhdat-intensivnost-cveta)                        | Ждать, пока значение, возвращаемое сенсором цвета на указанном порту, не будет сравнимо с указанным в значении параметра «Интенсивность». |
| <img src="/files/-M56mGb43Mdi4YCroFk0" alt="" data-size="original"> | [Ждать свет](/ev3/blocks.md#zhdat-svet)                                                     | Ждать, пока значение, возвращаемое сенсором света на указанном порту, не будет сравнимо с указанным в значении параметра «Проценты».      |
| <img src="/files/-M56mVXeNHE0ffFkNXqM" alt="" data-size="original"> | [Ждать датчик расстояния](/ev3/blocks.md#zhdat-datchik-rasstoyaniya)                        | Ждать, пока расстояние, возвращаемое ультразвуковым сенсором расстояния, не будет сравнимо с указанным в значении параметра «Расстояние». |
| <img src="/files/-M56mf01zgfYBuR6FY8C" alt="" data-size="original"> | [Ждать нажатия кнопки](/ev3/blocks.md#zhdat-nazhatiya-knopki)                               | Ждать нажатия на кнопку на корпусе робота.                                                                                                |
| <img src="/files/-M56miTUBXtXfBhDcWVs" alt="" data-size="original"> | [Ждать датчик звука](/ev3/blocks.md#zhdat-datchik-zvuka)                                    | Ждать, пока громкость, считанная микрофоном на заданном порту, не будет выше или ниже заданного значения.                                 |
| <img src="/files/-M56mmNtRvdUBR9JdqCB" alt="" data-size="original"> | [Ждать гиродатчик](/ev3/blocks.md#zhdat-girodatchik)                                        | Ждать, пока значение, возвращаемое гироскопом на указанном порту, не будет сравнимо с указанным в значении параметра «Значение».          |
| <img src="/files/-M56mshfe32GzFr4r84D" alt="" data-size="original"> | [Ждать приема сообщения](/ev3/blocks.md#zhdat-priema-soobsheniya)                           | Сохраняет сообщение от другого робота в заданную переменную.                                                                              |

### Получить сообщение из другой задачи

![Получить сообщение из другой задачи](/files/-M57GACe2xicMDkFMBK_)

Ждать получения сообщения из другой параллельной задачи.

Когда сообщение будет получено, оно будет присвоено указанной в блоке переменной.

Свойство «Дождаться сообщения» позволяет указать, что делать, если очередь сообщений пуста: дождаться прихода нового сообщения или продолжить работу, присвоив переменной пустую строку.

Сообщение автоматически приводится к типу, соответствующему типу переменной-приёмника. Пример: если вы посылаете число в виде строки, то оно будет принято как число.

### Ждать датчик касания

![Ждать датчик касания](/files/-M57GFPRMwfyQ9evZOK-)

Ждать, пока не сработает датчик касания.

Параметром указывается номер порта, к которому подключен датчик. Допустимые значения: 1, 2, 3, 4.

### Ждать энкодер

![Ждать энкодер](/files/-M57GMaMQrXcY-jLqI40)

Ждать, пока показания счетчика количества оборотов на заданном моторе не достигнут указанного в значении параметра «Предел оборотов».

Параметры:

1. &#x20;Порт — название порта, к которому подключен мотор (A, B или C).
2. Считанное значение — операция, которая будет использоваться для сравнения с введенным пределом оборотов.
3. &#x20;Предел оборотов.

### Ждать цвет

![Ждать цвет](/files/-M57GPqxO39aWZvhas3o)

Ждать, пока сенсор цвета в режиме распознавания цветов не вернет указанный цвет.

Параметры:

1. Цвет.
2. Порт — номер порта, к которому подключен датчик цвета.

### Ждать интенсивность цвета

![Ждать интенсивность цвета](/files/-M57GhlJTu1J8fHqUnGf)

Ждать, пока значение, возвращаемое сенсором цвета на указанном порту, не будет сравнимо с указанным в значении параметра «Интенсивность».

Параметры:

1. Интенсивность (от 0 до 100%).&#x20;
2. Порт — номер порта, к которому подключен сенсор цвета.
3. &#x20;Считанное значение — операция, которая будет использоваться для сравнения с введенной интенсивностью.

### Ждать свет

![Ждать свет](/files/-M57GlnGwPI6OkCgl-Zr)

Ждать, пока значение, возвращаемое сенсором света на указанном порту, не будет сравнимо с указанным в значении параметра «Проценты».

Параметры:

1. &#x20;Проценты (от 0 до 100%).
2. Порт — номер порта, к которому подключен сенсор цвета.
3. Считанное значение — операция, которая будет использоваться для сравнения со значением параметра «Проценты».

### Ждать датчик расстояния

![Ждать датчик расстояния](/files/-M57GunvskQgaV-BioFj)

Ждать, пока расстояние, возвращаемое ультразвуковым сенсором расстояния, не будет сравнимо с указанным в значении параметра «Расстояние».

Параметры:

1. Расстояние (в сантиметрах, от 0 до 255).
2. &#x20;Порт — номер порта, к которому подключен датчик расстояния.
3. &#x20;Считанное значение — операция, которая будет использоваться для сравнения с введенным расстоянием.

### Ждать нажатия кнопки

![Ждать нажатия кнопки](/files/-M57GyZ_9wPexgPBmLRh)

Ждать нажатия на кнопку на корпусе робота.

### Ждать датчик звука

![Ждать датчик звука](/files/-M57H1fWGdnU7wdS-ScD)

Ждать, пока громкость, считанная микрофоном на заданном порту, не будет выше или ниже заданного значения.

### Ждать гиродатчик

![Ждать гиродатчик](/files/-M57H5iGABLMjMBX3aYm)

Ждать, пока значение, возвращаемое гироскопом на указанном порту, не будет сравнимо с указанным в значении параметра «Значение».

### Ждать приема сообщения

![Ждать приема сообщения](/files/-M57H87yKxae9RY4UjbB)

Сохраняет сообщение от другого робота в заданную переменную. Если сообщения нет, то робот ждет приход сообщения, если установлен флаг. Иначе в переменную установится значение по умолчанию.

## Рисование на дисплее

| Вид                                                                 | Название                                                                               | Описание                                                          |
| ------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| <img src="/files/-M56rtOMDfR6g5_1jNQ0" alt="" data-size="original"> | [Напечатать текст](/ev3/blocks.md#napechatat-tekst)                                    | Печатает заданную строку в заданном месте на экране робота.       |
| <img src="/files/-M56rvm1r4MX2P7TF2-7" alt="" data-size="original"> | [Очистить экран](/ev3/blocks.md#ochistit-ekran)                                        | Стереть всё, что нарисовано на экране.                            |
| <img src="/files/-M56ryU8rtduaz4XN9H9" alt="" data-size="original"> | [Нарисовать прямоугольник](/trik/programming-visual/blocks.md#narisovat-pryamougolnik) | Нарисовать на экране прямоугольник.                               |
| <img src="/files/-M56s0jqvpuPyPcDg62-" alt="" data-size="original"> | [Нарисовать точку](/ev3/blocks.md#narisovat-tochku)                                    | Нарисовать на экране точку в указанных координатах.               |
| <img src="/files/-M56s3LT-PexnnVwsPGL" alt="" data-size="original"> | [Нарисовать линию](/ev3/blocks.md#narisovat-liniyu)                                    | Нарисовать на экране отрезок.                                     |
| <img src="/files/-M56s5vWVZWtEpKXZ6LW" alt="" data-size="original"> | [Нарисовать круг](/ev3/blocks.md#narisovat-krug)                                       | Нарисовать на экране круг с заданным центром и заданным радиусом. |

### Напечатать текст

![Напечатать текст](/files/-M57HrZCkhjhwI638GHH)

Печатает заданную строку в заданном месте на экране робота.

Значение свойства «Текст» по умолчанию трактуется как строка в чистом виде, оно так и будет выведено на экран. Чтобы система считала, что это выражение на текстовом языке (это может быть полезно, например, при отладке значения переменных), поставьте галочку «Вычислять» в редакторе свойств.

### Очистить экран

![Очистить экран](/files/-M57HxGK9OFvO_CEfPQI)

Стереть всё, что нарисовано на экране.

### Нарисовать прямоугольник

![Нарисовать прямоугольник](/files/-M57I-7Ir4RsGtEXmeSb)

Нарисовать на экране прямоугольник.

Параметры:

1. &#x20;X, Y — координаты левого верхнего угла.
2. &#x20;Ширина прямоугольника.
3. &#x20;Высота прямоугольника.
4. &#x20;Обновить картинку (истина или ложь).

### Нарисовать точку

![Нарисовать точку](/files/-M57I11TlMetL8j134ng)

Нарисовать на экране точку в указанных координатах.

### Нарисовать линию

![Нарисовать линию](/files/-M57I36aRtLURLo60H13)

Нарисовать на экране отрезок.

Параметры:

1. &#x20;X1, Y1 — координаты начала отрезка.
2. &#x20;X2, Y2 — координаты конца отрезка.
3. &#x20;Обновить картинку (истина или ложь).

### Нарисовать круг

![Нарисовать круг](/files/-M57I5TjiYgb74Ro14jr)

Нарисовать на экране круг с заданным центром и заданным радиусом.

Параметры:

1. &#x20;X, Y — координаты центра круга.
2. &#x20;Радиус круга.
3. &#x20;Обновить картинку (истина или ложь).

## Line Leader

| Вид                                                                 | Название                                                                                           | Описание                                          |
| ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| <img src="/files/-M56vuvs6niKvdoKFCMa" alt="" data-size="original"> | [Калибровка белого](/ev3/blocks.md#kalibrovka-belogo)                                              | Калибрует порог белого для сенсора.               |
| <img src="/files/-M56vy2TejfRFkTlsF1z" alt="" data-size="original"> | [Калибровка черного](/ev3/blocks.md#kalibrovka-chernogo)                                           | Калибрует порог черного для сенсора.              |
| <img src="/files/-M56w-kTOPpnlJeNwCyA" alt="" data-size="original"> | [Калибровка ПИД-регулятора](/ev3/blocks.md#kalibrovka-pid-regulyatora)                             | Устанавливает уставку сенсора                     |
| <img src="/files/-M56wF7L0LMv3Vz_jEaq" alt="" data-size="original"> | [Датчик линии в спящий режим](/ev3/blocks.md#datchik-linii-v-spyashii-rezhim)                      | Отправляет датчик линии в режим энергосбережения. |
| <img src="/files/-M56wM7qiLQ8vlFp219g" alt="" data-size="original"> | [Пробудить датчик линии](/ev3/blocks.md#probudit-datchik-linii)                                    | Включает датчик линии для работы.                 |
| <img src="/files/-M56wa_OQ7cyWR7j5Zfe" alt="" data-size="original"> | [Средневзвешенное значение в переменную](/ev3/blocks.md#srednevzveshennoe-znachenie-v-peremennuyu) | Считывает средневзвешенное значение в переменную. |
| <img src="/files/-M56wRyA_fYdi6eh4mTJ" alt="" data-size="original"> | [Считать сенсор в массив](/ev3/blocks.md#schitat-sensor-v-massiv)                                  | Считать значения с сенсора (восемь значений).     |
| <img src="/files/-M56wempv1KkjevuIuCZ" alt="" data-size="original"> | [Управляющее значение в переменную](/ev3/blocks.md#upravlyayushee-znachenie-v-peremennuyu)         | Считывает управляющее значение в переменную.      |

### Калибровка белого

![Калибровка белого](/files/-M57HIU_O9PZbEfCGfMA)

Калибрует порог белого для сенсора. Должен находиться на белом.

### Калибровка черного

![Калибровка черного](/files/-M57HLTWqC4W5pC7WBLF)

Калибрует порог черного для сенсора. Должен находиться на черном.

### Калибровка ПИД — регулятора

![Калибровка ПИД-регулятора](/files/-M57HO47MzQdj-LKk8g-)

Устанавливает уставку сенсора (середина сенсора над линией), П/(П фактор), И/(И фактор), Д/(Д фактор).

### Датчик линии в спящий режим

![Датчик линии в спящий режим](/files/-M57HTxfkitJVVQudSX8)

Отправляет датчик линии в режим энергосбережения.

### Пробудить датчик линии

![Пробудить датчик линии](/files/-M57HWZf_pkR3VblmjpG)

Включает датчик линии для работы.

### Средневзвешенное значение в переменную

![Средневзвешенное значение в переменную](/files/-M57HZqFNl5oxW7cGGky)

Считывает средневзвешенное значение в переменную.

Значение высчитывается внутри сенсора, где каждый из восьми сенсоров берется с коэффициентом, и вычисляется среднее.

Ожидается значение от 0 до 80 (-1 — ошибка).

### Считать сенсор в массив

![Считать сенсор в массив](/files/-M57Hc3Ku-twMRg4VJE4)

Считать значения с сенсора (восемь значений). Значения от 0 до 100. 0 — черный, 100 — белый.

### Управляющее значение в переменную

![Управляющее значение в переменную](/files/-M57HhcgnnGrahpgSkrf)

Считывает управляющее значение в переменную. Значение высчитывается внутри сенсора и может быть использовано сразу для моторов.

Ожидается значение от -100 до 100 (-101 — ошибка)
