Cheese Stick

Объявление экземпляра

После добавления блока Cheese Stick(CheeseStick) в рабочую область в код Python автоматически вставляется следующее объявление экземпляра:

cheesestick = CheeseStick(0)
# Когда экземпляров несколько
cheesestick_1 = CheeseStick(1)

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
index	Пункт выпадающего списка	Номер экземпляра (начиная с 0)	Целое число 0 или больше	0

Настроить порт как вход

Задаёт режим входа выбранного порта.

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
unit	Пункт выпадающего списка	Порт входа	Sa, Sb, Sc, La, Lb, Lc	-
option	Пункт выпадающего списка	Режим входа	makey(makey), кнопка(button), цифровой pullup(digital_pullup), цифровой pulldown(digital_pulldown), аналоговый(analog), аналоговое напряжение(analog_voltage)	-

Python

cheesestick = CheeseStick(0)

cheesestick.set_input_mode('Sa', 'button')

Преобразовать диапазон входа

Преобразует входное значение выбранного порта в заданный диапазон от минимума до максимума.
Диапазон входного значения — от 0 до 255.
Диапазон значений, в которые можно преобразовать, — от -100 до 100.

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
unit	Пункт выпадающего списка	Порт входа	Sa, Sb, Sc, La, Lb, Lc	-
src_min	Ввод (поле)	Минимальное значение источника	Целое число от 0 до 255	-
src_max	Ввод (поле)	Максимальное значение источника	Целое число от 0 до 255	-
dst_min	Ввод (поле)	Минимальное значение после преобразования	Целое число от -100 до 100	-
dst_max	Ввод (поле)	Максимальное значение после преобразования	Целое число от -100 до 100	-

Python

cheesestick = CheeseStick(0)

cheesestick.set_input_range('Sa', 0, 255, 0, 100)

Преобразовать диапазон входа со средним значением

Преобразует входное значение выбранного порта в заданный диапазон: минимум, среднее значение, максимум.
Диапазон входного значения — от 0 до 255.
Диапазон значений, в которые можно преобразовать, — от -100 до 100.

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
unit	Пункт выпадающего списка	Порт входа	Sa, Sb, Sc, La, Lb, Lc	-
src_min	Ввод (поле)	Минимальное значение источника	Целое число от 0 до 255	-
src_median	Ввод (поле)	Среднее значение источника	Целое число от 0 до 255	-
src_max	Ввод (поле)	Максимальное значение источника	Целое число от 0 до 255	-
dst_min	Ввод (поле)	Минимальное значение после преобразования	Целое число от -100 до 100	-
dst_median	Ввод (поле)	Среднее значение после преобразования	Целое число от -100 до 100	-
dst_max	Ввод (поле)	Максимальное значение после преобразования	Целое число от -100 до 100	-

Python

cheesestick = CheeseStick(0)

cheesestick.set_input_range_median('Sa', 0, 128, 255, -100, 0, 100)

Значение входа

Входное значение выбранного порта

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
unit	Пункт выпадающего списка	Порт входа	Sa, Sb, Sc, La, Lb, Lc	-

Python

cheesestick = CheeseStick(0)

cheesestick.get_input('Sa')

Установить режим импульсного входа

Задаёт режим импульсного входа выбранного порта.

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
unit	Пункт выпадающего списка	Порт импульсного входа	Sc, Lc	-
option	Пункт выпадающего списка	Режим подтяжки	импульс (default), импульс (pull-up), импульс (pull-down)	-

Python

cheesestick = CheeseStick(0)

cheesestick.set_pulse_input_mode('Sc', 'pull-up')

Значение импульсного входа

Обнаружен ли импульс на выбранном порте

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
unit	Пункт выпадающего списка	Порт импульсного входа	Sc, Lc	-

Python

cheesestick = CheeseStick(0)

cheesestick.get_pulse_input('Sc')

Установить цифровой выход

Задаёт значение цифрового выхода выбранного порта.
На выбор есть значения 0 и 1.

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
unit	Пункт выпадающего списка	Порт цифрового выхода	Sa, Sb, Sc, La, Lb, Lc, Mab, Mcd	-
value	Пункт выпадающего списка	Значение выхода	0 или 1	-

Python

cheesestick = CheeseStick(0)

cheesestick.set_digital_output('Sa', 1)

Установить ШИМ-выход

Задаёт значение ШИМ-выхода выбранного порта.
Диапазон значений на выбор — от 0 до 100.

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
unit	Пункт выпадающего списка	Порт ШИМ-выхода	Sa, Sb, Sc, La, Lb, Lc	-
value	Ввод (поле)	Значение ШИМ	Целое число от 0 до 100	-

Python

cheesestick = CheeseStick(0)

cheesestick.set_pwm_output('Sa', 50)

Изменить ШИМ-выход

Изменяет значение ШИМ-выхода выбранного порта.
Диапазон значений на выбор — от -100 до 100.

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
unit	Пункт выпадающего списка	Порт ШИМ-выхода	Sa, Sb, Sc, La, Lb, Lc	-
value	Ввод (поле)	Изменение значения ШИМ	Целое число от -100 до 100	-

Python

cheesestick = CheeseStick(0)

cheesestick.change_pwm_output('Sa', 10)

Установить частоту зуммера

Задаёт звук зуммера модуля Cheese Stick.

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
hz	Ввод (блок)	Частота (Гц)	Вещественное число от 0 до 6553,5	-

Python

cheesestick = CheeseStick(0)

cheesestick.sound_buzz(440)

Играть ноту

Cheese Stick играет заданную ноту.

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
note	Пункт выпадающего списка	Нота	До(C), До#(C#), Ре(D), Ре#(D#), Ми(E), Фа(F), Фа#(F#), Соль(G), Соль#(G#), Ля(A), Ля#(A#), Си(B)	-
octave	Пункт выпадающего списка	Октава	1, 2, 3, 4, 5, 6, 7	4

Python

cheesestick = CheeseStick(0)

cheesestick.sound_note('D', 5)

Воспроизвести звук

Cheese Stick воспроизводит выбранный звуковой клип.

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
clip	Пункт выпадающего списка	Название звукового клипа	'mute', 'beep', 'siren', 'engine', 'robot', 'happy', 'angry', 'sad' и другие	-
wait	Флажок	Ждать ли завершения	TRUE / FALSE	TRUE

Python

cheesestick = CheeseStick(0)

cheesestick.sound_clip('siren', wait=True)

Выключить звук

Выключает звук модуля Cheese Stick.

Параметры

(нет)

Python

cheesestick = CheeseStick(0)

cheesestick.sound_off()

Ускорение по оси

Значение ускорения свободного падения по выбранной оси

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
unit	Пункт выпадающего списка	Измеряемая ось	x, y, z	-

Python

cheesestick = CheeseStick(0)

cheesestick.acceleration('x')

Температура

Значение датчика температуры

Параметры

(нет)

Python

cheesestick = CheeseStick(0)

cheesestick.temperature()

Уровень сигнала

Уровень сигнала

Параметры

(нет)

Python

cheesestick = CheeseStick(0)

cheesestick.signal_strength()

Напряжение батареи

Напряжение батареи

Параметры

(нет)

Python

cheesestick = CheeseStick(0)

cheesestick.battery()

Изменение состояния

Изменилось ли состояние робота

Параметры

Название	Вид	Описание	Диапазон / Тип	По умолчанию
unit	Пункт выпадающего списка	Вид состояния	От 0 до 7 (см. таблицу ниже)	-

unit	Условие
0	acceleration('x') > 960
1	acceleration('x') < -960
2	acceleration('y') > 960
3	acceleration('y') < -960
4	acceleration('z') > 960
5	acceleration('z') < -960
6	tap() (событие постукивания)
7	fall() (событие падения)

Python

cheesestick = CheeseStick(0)

cheesestick.acceleration('x') > 960
cheesestick.tap()    # случай 6
cheesestick.fall()   # случай 7