Мозг#

Введение#

В VEX EXP C++ объект Brain представлен классом brain Вы создаете (или используете предоставленный проектом по умолчанию) объект Brain, а затем получаете доступ к функциям Brain через его объекты-члены.

Производные классы#

Класс brain служит базовым классом для следующих производных классов:

Screen - Этот класс предоставляет доступ к встроенному цветному сенсорному экрану Brain, позволяя программам отображать текст, графику и получать сенсорный ввод.
Timer - Этот класс предоставляет высокоточные средства измерения времени для контроля затраченного времени и управления поведением, зависящим от времени, в программах.
Battery - Этот класс позволяет программам отслеживать состояние батареи «Мозга», включая напряжение, ток, емкость и температуру.
Button - Этот класс позволяет программам взаимодействовать с кнопками Мозга.
ThreeWirePort (triport / 3-Wire Port) - Этот класс обеспечивает доступ к 3-проводным портам блока управления для подключения и управления устаревшими датчиками и устройствами, такими как концевые выключатели, потенциометры и светодиоды.
SDcard - Этот класс позволяет читать и записывать данные на SD-карту Brain для хранения файлов, регистрации данных и загрузки внешних ресурсов.

Конструкторы классов#

brain();

Параметры#

Конструктор brain не использует параметров.

Примечания#

В проекте следует создавать только один объект типа brain.

Пример#

// Create the EXP Brain
brain Brain = brain();

Функции участников#

Класс brain включает следующие функции-члены:

playSound - Воспроизводит один из встроенных звуковых эффектов Мозга.
playNote - Воспроизводит музыкальную ноту в течение определенного времени.
programStop - Останавливает текущий запущенный проект на EXP Brain.
timer - Возвращает текущее значение внутреннего таймера Brain в указанных единицах.
resetTimer - Сбрасывает внутренний таймер мозга на ноль и перезапускает отсчет времени.
setTimer - Устанавливает внутренний таймер Brain на указанное значение и единицу времени.

Перед вызовом любых функций-членов brain необходимо создать экземпляр brain , как показано ниже:

// Create the EXP Brain
brain Brain = brain();

playSound#

Воспроизводит один из встроенных звуков системы Brain.

Available Functions

void playSound(
    soundtype sound,
    uint32_t volume = 50 );

Parameters

Параметры	Тип	Описание
`sound`	`soundtype`	Заданный звук для воспроизведения из головного устройства.
`volume`	`uint32_t`	Необязательный параметр. Громкость воспроизведения звука в виде целого числа от 0% до 100%. Значение по умолчанию — 50%.

Название звука	Воспроизвести звук
`alarm`
`alarm2`
`doorClose`
`fillup`
`headlightsOff`
`headlightsOn`
`powerDown`
`ratchet`
`ratchet2`
`siren`
`siren2`
`tada`
`tollBooth`
`wrench`
`wrongWay`
`wrongWaySlow`

Return Values

Эта функция не возвращает значения.

playNote#

Воспроизводит музыкальную ноту из мозга.

Available Functions

1 - Сыграйте музыкальную ноту.
void playNote(
    int32_t octave,
    int32_t note );

2 - Воспроизводит ноту заданной длительности и громкости.
void playNote(
    int32_t octave,
    int32_t note,
    int32_t duration,
    int32_t volume = 50 );

Parameters

Параметры	Тип	Описание
`octave`	`int32_t`	Целое число, обозначающее октаву, в которой играется нота: `1` до `3` - низкая октава `4` до `7` - высокая октава
`note`	`int32_t`	Ноты для исполнения: `0` - C `1` - D `2` - E `3` - F `4` - G `5` - A `6` - B
`duration`	`int32_t`	Необязательный параметр. Длительность воспроизведения ноты в миллисекундах, максимум 500 миллисекунд. Если длительность не указана, используется значение по умолчанию — 500 миллисекунд.
`volume`	`int32_t`	Необязательный параметр. Громкость воспроизведения звука в виде целого числа от 0% до 100%. Значение по умолчанию — 50%.

Return Values

Эта функция не возвращает значения.

программаОстановить#

Останавливает текущий запущенный проект на устройстве EXP Brain.

Available Functions

void programStop();

Parameters

Эта функция не принимает никаких параметров.

Return Values

Эта функция не возвращает значения.

Examples

// Stop the project when the Brain screen is pressed
while (true) {
  if (Brain.Screen.pressing()) {
    Brain.programStop();
  }
  wait(20, msec);
}

таймер#

Возвращает текущее значение внутреннего таймера Brain в указанных единицах измерения.

Available Functions

double timer(
  timeUnits units );

Parameters

Параметр	Тип	Описание
`units`	`timeUnits`	Единица времени возвращения: `seconds` / `sec` секунд `msec` миллисекунд

Параметр

Тип

Описание

units

timeUnits

Единица времени возвращения:

seconds / sec секунд
msec миллисекунд

Return Values

Возвращает значение типа double представляющее собой время, прошедшее с момента запуска программы, в указанных единицах измерения.

Examples

Таймер запускается автоматически при начале проекта.
Таймер можно сбросить с помощью resetTimer.

Examples

// Stop the project after 3 seconds
while (Brain.timer(seconds) < 3) {
  wait(20, msec);
}

Brain.programStop();

resetTimer#

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

Available Functions

void resetTimer();

Parameters

Эта функция не принимает никаких параметров.

Return Values

Эта функция не возвращает значения.

Notes

Таймер начинает отсчет заново сразу после сброса.
Вызов функции resetTimer ) влияет на значение, возвращаемое последующими вызовами функции timer.

Examples

// Reset the timer and measure elapsed time
Brain.resetTimer();

while (Brain.timer(sec) < 5) {
  wait(20, msec);
}

// 5 seconds have elapsed since reset
Brain.Screen.print("5 seconds passed");

setTimer#

Устанавливает внутренний таймер «Мозга» на заданное значение и единицу времени.

Available Functions

void setTimer(
  double value,
  timeUnits units );

Parameters

Параметр	Тип	Описание
`value`	`double`	Время, на которое нужно установить таймер, исходя из `timeUnits` указанного в параметре `units`.
`units`	`timeUnits`	Единицы измерения, используемые для интерпретации значения `value` : `seconds` / `sec` - секунды `msec` - миллисекунды

Параметр

Тип

Описание

value

double

Время, на которое нужно установить таймер, исходя из timeUnits указанного в параметре units.

units

timeUnits

Единицы измерения, используемые для интерпретации значения value :

seconds / sec - секунды
msec - миллисекунды

Return Values

Эта функция не возвращает значения.

Notes

Таймер продолжает отсчет вперед после установки значения.
Вызов функции setTimer немедленно изменяет значение, возвращаемое функцией timer.

Examples

// Set the timer to start at 10 seconds
Brain.setTimer(10, sec);

// Wait until the timer is at 3 seconds
while (Brain.timer(sec) < 3) {
  wait(20, msec);
}

// 5 seconds have elapsed since setTimer was called
Brain.Screen.print("5 seconds passed");