Arduino default parameter

ino does not support default values properly. #2158


jantje commented Jul 2, 2014

This may be accepted as a limitation of the system but following code does not compile in the arduino ide 1.5.5 (and I assume all others)

The text was updated successfully, but these errors were encountered:

matthijskooijman commented Jul 2, 2014

I presume that either the IDE doesn’t recognize the beep definition and cannot provide a forward declaration, or it includes the default arguments in the generated forward declaration which causes the compiler to barf. An error message would be helpful :-)

jantje commented Jul 2, 2014

actually the IDE doesn’t make a link between the 2 beeps and as such it is a simple «error: ‘beep’ was not declared in this scope»
Even with beep(1,true); there is no link and as such no declaration function generated.
So the same error is generated.
It looks like the ino format simply does not support default values for parameters.
As I don’t see a good way to handle these parameter I’d be happy to get confirmed that «when parsing ino files; ignore functions that have default values» is a design decision the arduino core team took.

So basically I think I agree with «I presume that the IDE doesn’t recognize the beep definition and cannot provide a forward declaration»

matthijskooijman commented Jul 2, 2014

Ok, the error you’re seeing is simply how C++ works: you can only reference functions defined earlier in the file (unless you add a forward declaration). The IDE normally inserts forward declarations automatically as a service to the user, but I suspect that it doesn’t recognize the function definition because of the default arguments. I doubt this is a design decision — it’s probably just that the regex used isn’t extensive enough (and this is, IMHO, exactly why doing this automatic forward declaration and similar stuff in the IDE is a bad idea — you need a proper parser to really be able to cover all cases. )

jantje commented Jul 2, 2014

identification is a problem but I think finding a solution is even harder.
If you forward declare

you get an error
if you forward declare

you also get an error
So the only solution I see is
foward declare

Not something I would look forward doing.

matthijskooijman commented Jul 2, 2014

Good point — when a forward declaration is present, default arguments should be present only on the forward declaration, not on the definition. I guess this would be wontfix, though this is up to @cmaglie and friends :-)

jantje commented Jul 2, 2014

I assume the arduino core team hit this problem (like I hit it in my plugin today) and decided not to support functions with default parameter values.
I just would like to be sure.

xaljox commented Jul 3, 2014

It is not something the arduino IDE team can do something about. It is in the GCC compiler, the same as eclipse is using. It is more or less a C++ thing. If you allow defualt parameters on the forward declarion AND on the actual implementation you could set them to different values and then it can get tricky as to use wich value. Thus only in the (forward) declaration the default parameters are allowed in C++.
It is to my knowledge not a compiler specific thing, since Visual studio does the same and Xcode as far as I know also. In the past Xcode also used GCC, but they use now another newer compiler.

On 02 Jul 2014, at 22:58, jantje wrote:

I assume the arduino core team hot this problem (like I hit it in my plugin today) and decided not to support functions with default parameter values.
I just would like to be sure.

Reply to this email directly or view it on GitHub.


Problem with a function having a parameter with a default value

I’ve got a problem using a default value for a function parameter.

This code gives «‘blink’ was not declared in this scope»:

but it works if I don’t assign a default value to the «l» arg:

or if I put the blink function before the loop:

2 Answers 2

It’s just a failing of the Arduino build process to generate prototypes (function declarations) for functions that have default argument values. There’s otherwise nothing wrong with what you’re doing. Not in my opinion anyway. The build process sometimes chokes on function or class templates as well. The answer to these sorts of problems is probably that these features are not considered part of the Arduino «language».

Just a reminder: In C++ a function declaration needs to have been seen in order to generate a call to it. A definition will serve as a declaration. In either case, one must have been seen before the call site. Generating declarations where needed is, perhaps, the greater part of what the Arduino build process does that can be said to make the Arduino «language» different from plain C++.

The following were generated by working out of /tmp/default-param with the «input» being default-param.ino, running:

and inspecting /tmp/build/sketch/default-param.ino.cpp which I’m calling «output». You can use the same process if you want to see exactly what the build process is doing to your code.

Non-default argument

The build process has inserted a valid C++ function declaration prior to the call site, so the compiler is happy.

With default argument

No declaration prior to the call site this time, so the compiler is not happy with this generated code.

Build process

The build process is a rather ugly. process. that scrapes the output of the compiler and generated ctags to build include paths and to try to generate forward references for things. Sometimes, it just gets it wrong. I’m not sure what the exact error is in the build process, but it is probably just a failure to match the error caused by calling an undeclared function with its matching entry in the ctags. You can try reading through the build process documentation to make sense of this. Ultimately though, you may have to read the source to arduino-cli/arduino-builder to get to exact cause.

Non-.ino (and non-.pde) files more or less go through the build process unscathed. So, if you really want default arguments, you can make use of and .h file for your function prototype/declaration and a .cpp file for its body and follow the normal rules of C++.

Using your own declaration

You can just make your own declaration for it. Doing so makes it not detect an error on that line.

As you can see it generates a proto type for whatever reason. But not one that conflicts with your own.

It is probably better if you want to make use of default arguments to just use headers and .cpp file for those functions that have them so that you’re not subject to changes in the ability of arudino-cli/arduino-builder to handle them.


Список команд Arduino

На этой странице представлен список всех (или почти всех) доступных “из коробки” команд для Arduino с кратким описанием и примерами. Часть информации взята из Гугла, в основном некоторые особенности языка, часть получена методом проб и ошибок. Полную информацию о том, как этим пользоваться, можно получить из уроков или официального reference. Также изо всех сил рекомендую вот этот онлайн справочник по C++, из него можно узнать гораздо больше о некоторых особенностях использования операторов и типов данных.

А ещё у меня есть краткий сборник всех основных Ардуино-функций для печати! Смотри в этом уроке.

Структура скетча

Синтаксис, структура кода

Ставится в конце каждого действия

Функция, содержимое которой выполняется один раз при запуске микроконтроллера. Подробнее – в этом уроке.

Функция, содержимое которой выполняется (или пытается выполняться) “по кругу” на протяжении всего времени работы МК. Подробнее – в этом уроке.

Директива, позволяющая подключать в проект дополнительные файлы с кодом.

В чём отличие <> и “”? Когда указываем название “в кавычках”, компилятор сначала ищет файл в папке со скетчем, а затем в папке с библиотеками. При использовании компилятор ищет файл только в папке с библиотеками

Директива, дающая команду препроцессору заменить указанное название на указанное значение. Чаще всего таким образом объявляют константы:

После компиляции все встречающиеся в тексте программы слова MOTOR_PIN будут заменены на цифру 10, а LED_PIN – на цифру 3. Такой способ хранения констант не использует оперативную память микроконтроллера. Также define позволяет делать т.н. макро функции. Например Ардуиновская функция sq (квадрат) является макро, который при компиляции превращается в умножение:

Директивы препроцессору, позволяющие включать или исключать участки кода по условию

При помощи условной компиляции очень удобно собирать и настраивать сложные проекты с кучей настроек и библиотек, подключаемых “по условию”. Например:

Если параметру DEBUG установить 1, то будет подключена библиотека Serial, если 0 – то нет. Таким образом получаем универсальный оптимизированный проект с отладкой. Подробнее – в этом уроке.

Условные директивы препроцессору, позволяют включать или исключать участки кода по условию: ifdef – определено ли? ifndef – не определено ли? Подробнее – в этом уроке.

Оператор перехода в другую часть кода по метке. Не рекомендуется к использованию, всегда можно обойтись без него. Как пример использования – выход из кучи условий

Оператор прерывания функции, он же оператор возврата значения из функции. Подробнее – в этом уроке

Условия (if, switch)

Оператор сравнения и его друзья. Подробнее – в этом уроке.

Укороченная запись условия: (логика) ? правда : ложь. Подробнее – в этом уроке.

Оператор выбора, заменяет конструкцию с else if. Подробнее – в этом уроке.

Оператор break очень важен, позволяет выйти из switch. Но можно использовать так:

Циклы (for, while)

Цикл – “счётчик”. for (инициализация; условие; инкремент). Подробнее – в этом уроке.

Также используется для создания замкнутых циклов, т.к. настройки for необязательны. Выход только через break или goto

Цикл с предусловием. Подробнее – в этом уроке.

Может быть использован для создания замкнутого цикла, выход только через break или goto

Цикл с постусловием. Подробнее – в этом уроке.

Отличается от while тем, что гарантированно выполнится хотя бы один раз

Пропускает все оставшиеся в теле цикла действия и переходит к следующей итерации

Выходит из цикла


Запятая ,

Запятая тоже является оператором, используется в следующих случаях:

  • Перечисление элементов в массивах (урок про массивы)
  • Перечисление аргументов в функциях (урок про функции)
  • Выполнение последовательности действий (сделать это И это)

Рассмотрим третий случай здесь:


Арифметические операторы – самые простые и понятные из всех

  • = присваивание
  • % остаток от деления
  • * умножение
  • / деление
  • + сложение
  • — вычитание

Большой урок по математическим действиям.

Сравнение и логика

  • == равенство (a == b)
  • != неравенство (a != b)
  • >= больше или равно
  • меньше или равно
  • > больше
  • меньше
  • ! логическое НЕ, отрицание. Аналог – оператор not
  • && логическое И. Аналог – оператор and
  • || логическое ИЛИ. Аналог – оператор or

Подробный урок по сравнениям и условиям.

Составные операторы

  • ++ (плюс плюс) инкремент: a++ равносильно a = a + 1
  • — (минус минус) декремент: a — равносильно a = a – 1
  • += составное сложение: a += 10 равносильно a = a + 10
  • -= составное вычитание: a -= 10 равносильно a = a – 10
  • *= составное умножение: a *= 10 равносильно a = a * 10
  • /= составное деление: a /= 10 равносильно a = a / 10
  • %= прибавить остаток от деления: a %= 10 равносильно a = a + a % 10
  • &= составное битовое И: a &= b равносильно a = a & b
  • ^= составное исключающее ИЛИ: a ^= b равносильно a = a ^ b
  • |= составное ИЛИ: a |= b равносильно a = a | b

По битовым операциям читай отдельный урок. По математическим операциям у меня тоже есть подробный урок.

Битовые операции

  • & битовое И
  • битовый сдвиг влево
  • >> битовый сдвиг вправо
  • ^ битовое исключающее ИЛИ (аналогичный оператор – xor)
  • | битовое ИЛИ

По битовым операциям читай урок у меня на сайте.

Указатели и ссылки

  • & – возвращает адрес данных в памяти (адрес первого блока данных)
  • * – возвращает значение по указанному адресу
  • -> – оператор косвенного обращения к членам и методам (для указателей на структуры и классы). Является короткой записью конструкции через указатель: a->b равносильно (*a).b

Подробнее об указателях и ссылках читайте в отдельном уроке.

Работа с данными

Типы данных, переменные

Переменная – элементарная ячейка для хранения данных (цифр). Переменные разных типов имеют разный “размер ячейки” и имеют разный лимит на размер числа.

Название Альт. название Вес Диапазон Особенность
boolean bool 1 байт 0 или 1, true или false Логическая переменная. bool на Arduino тоже занимает 1 байт, а не бит!
char int8_t 1 байт -128… 127 Хранит номер символа из таблицы символов ASCII
byte uint8_t 1 байт 0… 255
int int16_t, short 2 байта -32 768… 32 767
unsigned int uint16_t, word 2 байта 0… 65 535
long int32_t 4 байта -2 147 483 648… 2 147 483 647 – 2 миллиарда… 2 миллиарда
unsigned long uint32_t 4 байта 0… 4 294 967 295 0… 4 миллиарда…
float 4 байта -3.4028235E+38… 3.4028235E+38 Хранит числа с плавающей точкой (десятичные дроби). Точность: 6-7 знаков
double 4 байта Для AVR то же самое, что float. А так он 8 байт
int64_t 8 байт -(2^64)/2… (2^64)/2-1 Очень большие числа. Serial не умеет такие выводить
uint64_t 8 байт 2^64-1 Очень большие числа. Serial не умеет такие выводить

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

  • wchar_t – 16 битный символ
  • char16_t – 2-х байтный char
  • char32_t – 4-х байтный char

Также есть такое понятие, как переопределение типов данных (не создавая новых типов), для этого используется ключевое слово typedef. Typedef работает следующим образом: typedef ; – создать новый тип данных на основе типа . Пример:

Создаёт тип данных под названием color, который будет абсолютно идентичен типу byte (то есть принимать 0-255). Теперь с этим типом можно создавать переменные:

Создали три переменные типа color, который тот же byte, только в профиль. Это всё!

Более подробно о переменных и данных можно почитать вот здесь.


Структура (struct) – очень составной тип данных: совокупность разнотипных переменных, объединённых одним именем.

Ярлык будет являться новым типом данных, и, используя этот ярлык, можно объявлять уже непосредственно саму структуру:

Также есть вариант объявления структуры без создания ярлыка, т.е. создаём структуру, не объявляя её как тип данных со своим именем.

  • Обращение к члену структуры производится вот по такой схеме: . и позволяет менять или читать значение.
  • Если две структуры имеют одинаковую структуру (объявлены одним ярлыком) то можно одну структуру просто приравнять к другой, все переменные запишутся соответственно на свои места.
  • Ещё одним удобным вариантом является присваивание значения вот таким образом: = ( ) , , >;

Более подробно про структуры читай тут.


Перечисления (enum – enumeration) – тип данных, представляющий собой набор именованных констант, нужен в первую очередь для удобства программиста.

Объявление перечисления чем-то похоже на объявление структуры:

Таким образом мы объявили ярлык. Теперь, используя этот ярлык, можно объявить само перечисление:

Также как и у структур, можно объявить перечисление без создания ярлыка (зачем нам лишняя строчка?):

Созданное таким образом перечисление является переменной, которая может принимать указанные для неё , также с этими именами её можно сравнивать. Теперь самое главное: имена для программы являются числами, начиная с 0 и далее по порядку увеличиваясь на 1. В абстрактном примере выше равно 0, равно 1, равно 2, и так далее. Помимо указанных имён, перечислению можно приравнять и число напрямую, но как бы зачем.

Более подробно про перечисления читай тут.


Классы в С++ – это основной и очень мощный инструмент языка, большинство “библиотек” являются классами. Иерархия такая:

Класс объявляется следующим образом:

Более подробно про работу с классами читай вот в этом уроке про классы.


Для объявления массива достаточно указать квадратные скобки после имени переменной, тип данных – любой. Более подробно про массивы читай в уроке.

Строки (объект String)

String – очень мощный инструмент для работы со строками, т.е. текстовыми данными. Объявить строку можно несколькими способами:

Подробнее про строки String и массивы символов читай в этом уроке.

Строки можно сравнивать, складывать и вычитать, также для работы с ними есть куча функций:


Возвращает элемент строки myString под номером index. Аналог – myString[index];

myString.setCharAt(index, val);

Записывает в строку myString символ val на позицию index. Аналог – myString[index] = val;


  • Возвращает отрицательное число, если myString идёт до myString2
  • Возвращает положительное число, если myString идёт после myString2
  • Возвращает 0, если строки одинаковы


Присоединяет value к строке (value может иметь любой численный тип данных). Возвращает true при успешном выполнении, false при ошибке. Аналог – сложение, myString + value;


Проверяет, заканчивается ли myString символами из myString2. В случае совпадения возвращает true


Проверяет, начинается ли myString символами из myString2. В случае совпадения возвращает true


Возвращает true, если myString совпадает с myString2. Регистр букв важен

myString.equalsIgnoreCase (myString2);

Возвращает true, если myString совпадает с myString2. Регистр букв неважен

myString.indexOf(val, from);

Ищет и возвращает номер (позицию) значения val в строке, ищет слева направо, возвращает номер первого символа в совпадении. val может быть char или String, то есть ищем в строке другую строку или символ. Можно искать, начиная с позиции from. В случае, когда не может найти val в строке, возвращает -1.

myString.lastIndexOf(val, from);

Ищет и возвращает номер (позицию) значения val в строке, ищет справа налево, возвращает номер последнего символа в совпадении. val может быть char или String, то есть ищем в строке другую строку или символ. Можно искать, начиная с позиции from. В случае, когда не может найти val в строке, возвращает -1.


Возвращает длину строки в количестве символов

myString.remove(index, count);

Удаляет из строки символы, начиная с index и до конца, либо до указанного count

myString.replace(substring1, substring2);

В строке myString заменяет последовательность символов substring1 на substring2.


Зарезервировать в памяти количество байт size для работы со строкой


Преобразовывает строку в “СИ” формат (null-terminated string) и возвращает указатель на полученную строку


Удаляет пробелы из начала и конца строки. Действует со строкой, к которой применяется

myString.substring(from, to);

Возвращает кусок строки, содержащейся в myString начиная с позиции from и до конца, либо до позиции to

myString.toCharArray(buf, len);

Раскидывает строку в массив – буфер buf (типа char []) с начала и до длины len

myString.getBytes(buf, len);

Копирует указанное количество символов len (вплоть до unsigned int) в буфер buf (byte [])


Возвращает содержимое строки в тип данных float


Возвращает содержимое строки в тип данных double


Возвращает содержимое строки в тип данных int


Переводит все символы в нижний регистр. Было ААААА – станет ааааа


Переводит все символы в верхний регистр. Было ааааа – станет ААААА

Спецификаторы переменных

  • const – константа, такую переменную нельзя изменить (будет ошибка). const int val = 10;
  • static – позволяет объявить локальную переменную внутри функции, и эта переменная не будет заново переобъявляться при повторном вызове функции. Эдакая локальная глобальная переменная. Почитать
  • volatile – указывает компилятору, что переменную не нужно оптимизировать, что её значение может меняться извне. Такой спецификатор должен быть применён к переменным, которые меняют своё значение в прерывании. Почитать
  • extern – указывает компилятору, что эта переменная объявлена в другом файле программы, но мы хотим пользоваться именно ей, а не создавать новую с таким же именем в этом файле программы. Позволяет читать/записывать в переменные, созданные в других файлах (библиотеках)!

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

Переменные разных типов данных могут быть преобразованы в друг друга, для этого достаточно указать нужный тип данных в скобках перед преобразуемой переменной (тип_данных)переменная . Результат вернёт переменную с новым типом данных, сам же тип данной у переменной не изменится (работает в рамках одного действия):

Таким образом можно преобразовывать обычные переменные, указатели и другие типы данных.

И для строк мы уже рассматривали выше

Иногда можно встретить преобразование типов через оператор cast . Отличную статью можно глянуть на Хабре, а я кратко опишу 4 основных каста:

  • reinterpret_cast – приведение типов без проверки, непосредственное указание компилятору. Применяется только в случае полной уверенности программиста в собственных действиях. Не снимает const и volatile , применяется для приведения указателя к указателю, указателя к целому и наоборот;
  • static_cast – преобразует выражения одного статического типа в объекты и значения другого статического типа. Поддерживается преобразование численных типов, указателей и ссылок по иерархии наследования как вверх, так и вниз. Преобразование проверяется на уровне компиляции и в случае ошибки приведения типов будет выдано сообщение;
  • dynamic_cast – используется для динамического приведения типов во время выполнения. В случае неправильного приведения типов для ссылок вызывается исключительная ситуация std::bad_cast, а для указателей будет возвращен 0;
  • const_cast – самое простое приведение типов. Снимает const и volatile , то есть константность и отказ от оптимизации компилятором переменной. Это преобразование проверяется на уровне компиляции и в случае ошибки приведения типов будет выдано сообщение.

Как пользоваться: на примере предыдущего примера

Подробный урок по типам данных смотри тут.

“Символьные” функции

Все следующие функции принимают как аргумент символ (тип char), анализируют его и возвращают true или false в зависимости от предназначения.

  • isAlpha(thisChar) – возвращает true, если thisChar – буква
  • isAlphaNumeric(thisChar) – возвращает true, если thisChar – буква или цифра
  • isAscii(thisChar) – возвращает true, если thisChar входит в таблицу ASCII
  • isControl(thisChar) – возвращает true, если thisChar – контрольный символ
  • isDigit(thisChar) – возвращает true, если thisChar – цифра
  • isGraph(thisChar) – возвращает true, если thisChar – печатаемый знак (кроме пробела)
  • isPrintable(thisChar) – возвращает true, если thisChar – печатаемый знак (включая пробел)
  • isHexadecimalDigit(thisChar) – возвращает true, если thisChar цифра 0-9 или буква A-F
  • isPunct(thisChar) – возвращает true, если thisChar – знак пунктуации
  • isLowerCase(thisChar) – возвращает true, если thisChar – буква в нижнем регистре (маленькая)
  • isUpperCase(thisChar) – возвращает true, если thisChar – буква в верхнем регистре (большая)
  • isSpace(thisChar) – возвращает true, если thisChar – пробел
  • isWhitespace(thisChar) – возвращает true, если thisChar – форматированный пробел (formfeed (‘\f’), newline (‘\n’), carriage return (‘\r’), horizontal tab (‘\t’), and vertical tab (‘\v’))

Работа с цифрами

Целые и дробные числа

Arduino поддерживает работу с целыми числами в разных системах исчисления:

Базис Префикс Пример Особенности
2 (двоичная) B или 0b (ноль бэ) B1101001 цифры 0 и 1
8 (восьмеричная) 0 (ноль) 0175 цифры 0 – 7
10 (десятичная) нет 100500 цифры 0 – 9
16 (шестнадцатеричная) 0x (ноль икс) 0xFF21A цифры 0-9, буквы A-F

ВАЖНО! Для арифметических вычислений по умолчанию используется ячейка long (4 байта), но при умножении и делении используется int (2 байта), что может привести к непредсказуемым результатам! Если при умножении чисел результат превышает 32’768, он будет посчитан некорректно. Для исправления ситуации нужно писать (тип данных) перед умножением, что заставит МК выделить дополнительную память для вычисления (например (long)35 * 1000). Также существую модификаторы, делающие примерно то же самое.

  • u или U – перевод в формат unsigned int (от 0 до 65’535). Пример: 36000u
  • l или L – перевод в формат long (-2 147 483 648… 2 147 483 647). Пример: 325646L
  • ul или UL – перевод в формат unsigned long (от 0 до 4 294 967 295). Пример: 361341ul

Посмотрим, как это работает на практике:

Arduino поддерживает работу с числами с плавающей точкой (десятичные дроби). Этот тип данных не является для неё “родным”, поэтому вычисления с ним производятся в несколько раз дольше, чем с целочисленным типом (около 7 микросекунд на действие). Arduino поддерживает три типа ввода чисел с плавающей точкой:

Тип записи Пример Чему равно
Десятичная дробь 20.5 20.5
Научный 2.34E5 2.34*10^5 или 234000
Инженерный 67e-12 67*10^-12 или 0.000000000067

С вычислениями есть такая особенность: если в выражении нет float чисел, то вычисления будут иметь целый результат (дробная часть отсекается). Для получения правильного результата нужно писать (float) перед действием, или использовать float числа при записи. Смотрим:

Ну и напоследок, при присваивании float числа целочисленному типу данных дробная часть отсекается. Если хотите математическое округление – его нужно использовать отдельно:

Математические функции и константы

Математических функций Arduino поддерживает очень много, малая часть из них являются макро функциями, идущими в комплекте с Arduino.h, все остальные же наследуются из мощной C++ библиотеки math.h

Функция Описание
cos (x) Косинус (радианы)
sin (x) Синус (радианы)
tan (x) Тангенс (радианы)
fabs (x) Модуль для float чисел
fmod (x, y) Остаток деления x на у для float
modf (x, *iptr) Возвращает дробную часть, целую хранит по адресу iptr
modff (x, *iptr) То же самое, но для float
sqrt (x) Корень квадратный
sqrtf (x) Корень квадратный для float чисел
cbrt (x) Кубический корень
hypot (x, y) Гипотенуза ( корень(x*x + y*y) )
square (x) Квадрат ( x*x )
floor (x) Округление до целого вниз
ceil (x) Округление до целого вверх
frexp (x, *pexp)
ldexp (x, exp) x*2^exp
exp (x) Экспонента (e^x)
cosh (x) Косинус гиперболический (радианы)
sinh (x) Синус гиперболический (радианы)
tanh (x) Тангенс гиперболический (радианы)
acos (x) Арккосинус (радианы)
asin (x) Арксинус (радианы)
atan (x) Арктангенс (радианы)
atan2 (y, x) Арктангенс (y / x) (позволяет найти квадрант, в котором находится точка)
log (x) Натуральный логарифм х ( ln(x) )
log10 (x) Десятичный логарифм x ( log_10 x)
pow (x, y) Степень ( x^y )
isnan (x) Проверка на nan (1 да, 0 нет)
isinf (x) Возвр. 1 если x +бесконечность, 0 если нет
isfinite (x) Возвращает ненулевое значение только в том случае, если аргумент имеет конечное значение
copysign (x, y) Возвращает x со знаком y (знак имеется в виду + -)
signbit (x) Возвращает ненулевое значение только в том случае, если _X имеет отрицательное значение
fdim (x, y) Возвращает разницу между x и y, если x больше y, в противном случае 0
fma (x, y, z) Возвращает x*y + z
fmax (x, y) Возвращает большее из чисел
fmin (x, y) Возвращает меньшее из чисел
trunc (x) Возвращает целую часть числа с дробной точкой
round (x) Математическое округление
lround (x) Математическое округление (для больших чисел)
lrint (x) Округляет указанное значение с плавающей запятой до ближайшего целого значения, используя текущий режим округления и направление
Константа Значение
INT8_MAX 127
UINT16_MAX 65535
INT16_MAX 32767
UINT32_MAX 4294967295
INT32_MAX 2147483647
Функция Значение
min(a, b) Возвращает меньшее из чисел a и b
max(a, b) Возвращает большее из чисел
abs(x) Модуль числа
constrain(val, low, high) Ограничить диапазон числа val между low и high
map(val, min, max, outMin, outMax) Перевести диапазон числа val (от min до max) в новый диапазон (от outMin до outMax). val = map(analogRead(0), 0, 1023, 0, 100); – получить с аналогового входа значения 0-100 вместо 0-1023. Работает только с целыми числами!
round(x) Математическое округление
radians(deg) Перевод градусов в радианы
degrees(rad) Перевод радиан в градусы
sq(x) Квадрат числа
Константа Значение Описание
INT8_MAX 127 Максимальное значение для char, int8_t
UINT8_MAX 255 Максимальное значение для byte, uint8_t
INT16_MAX 32767 Максимальное значение для int, int16_t
UINT16_MAX 65535 Максимальное значение для unsigned int, uint16_t
INT32_MAX 2147483647 Максимальное значение для long, int32_t
UINT32_MAX 4294967295 Максимальное значение для unsigned long, uint32_t
M_E 2.718281828 Число e
M_LOG2E 1.442695041 log_2 e
M_LOG10E 0.434294482 log_10 e
M_LN2 0.693147181 log_e 2
M_LN10 2.302585093 log_e 10
M_PI 3.141592654 pi
M_PI_2 1.570796327 pi/2
M_PI_4 0.785398163 pi/4
M_1_PI 0.318309886 1/pi
M_2_PI 0.636619772 2/pi
M_2_SQRTPI 1.128379167 2/корень(pi)
M_SQRT2 1.414213562 корень(2)
M_SQRT1_2 0.707106781 1/корень(2)
NAN __builtin_nan(“”) nan
INFINITY __builtin_inf() infinity
PI 3.141592654 Пи
HALF_PI 1.570796326 пол Пи
TWO_PI 6.283185307 два Пи
EULER 2.718281828 Число Эйлера е
DEG_TO_RAD 0.01745329 Константа перевода град в рад
RAD_TO_DEG 57.2957786 Константа перевода рад в град

Псевдослучайные числа

  • random(max) – возвращает случайное число в диапазоне от 0 до (max – 1)
  • random(min, max) – возвращает случайное число в диапазоне от min до (max – 1)
  • randomSeed(value) – дать генератору случайных чисел новую опорную точку для счёта. value – любое число. Обычно при старте программы (в setup) подают значение с неподключенного аналогового пина, получая таким образом 1024 набора случайных чисел

Биты и байты

Битовые операции – подробнее читай в отдельном уроке.

  • bit(val) – считает значение байта val по порядку (0 будет 1, 1 будет 2, 2 будет 4, 3 будет 8 и.т.д.)
  • bitClear(x, n) – устанавливает на 0 бит, находящийся в числе x под номером n
  • bitSet(x, n) – устанавливает на 1 бит, находящийся в числе x под номером n
  • bitWrite(x, n, b) – устанавливает на значение b (0 или 1) бит , находящийся в числе x под номером n
  • bitRead(x, n) – возвращает значение бита (0 или 1), находящегося в числе x под номером n
  • highByte(x) – извлекает и возвращает старший (крайний левый) байт переменной типа word (либо второй младший байт переменной, если ее тип занимает больше двух байт).
  • lowByte(x) – извлекает и возвращает младший (крайний правый) байт переменной (например, типа word).
  • bit_is_set(x, n) – проверка (возвращает 1 если включен) бита n в числе x
  • bit_is_clear(x, n) – проверка (возвращает 1 если выключен) бита n в числе x
  • loop_until_bit_is_set(x, n) – висеть в цикле (ждать), пока включен бит n в числе x
  • loop_until_bit_is_clear(x, n) – висеть в цикле (ждать), пока выключен бит n в числе x


Цифровые пины

Устанавливает режим работы пина pin (ATmega 328: D0-D13, A0-A5) на режим mode:

  • INPUT – вход (все пины сконфигурированы так по умолчанию)
  • OUTPUT – выход (при использовании analogWrite ставится автоматически)
  • INPUT_PULLUP – подтяжка к питанию (например для обработки кнопок)

Читает состояние пина pin и возвращает :

  • 0 или LOW – на пине 0 Вольт (точнее 0-2.5В)
  • 1 или HIGH – на пине 5 Вольт (точнее 2.5-опорное В)

Подаёт на пин pin сигнал value:

  • 0 или LOW – 0 Вольт (GND)
  • 1 или HIGH – 5 Вольт (точнее, напряжение питания)

Запускает генерацию ШИМ сигнала (отдельный урок про ШИМ) на пине pin со значением value. Для стандартного 8-ми битного режима это значение 0-255, соответствует скважности 0-100%. Подробнее о смене частоты и разрядности ШИМ смотрите в этом уроке. ШИМ пины:

  • ATmega 328/168 (Nano, UNO, Mini): D3, D5, D6, D9, D10, D11
  • ATmega 32U4 (Leonardo, Micro): D3, D5, D6, D9, D10, D11, D13
  • ATmega 2560 (Mega): D2 – D13, D44 – D46

Аналоговые пины

Читает и возвращает оцифрованное напряжение с пина pin. АЦП на большинстве плат Arduino имеет разрядность 10 бит, так что возвращаемое значение 0 – 1023 при напряжении 0 – опорное на пине. Урок про аналоговые пины.

Устанавливает режим работы АЦП согласно mode:

  • DEFAULT: опорное напряжение равно напряжению питания МК
  • INTERNAL: встроенный источник опорного на 1.1V для ATmega168 или ATmega328P и 2.56V на ATmega8
  • INTERNAL1V1: встроенный источник опорного на 1.1V (только для Arduino Mega)
  • INTERNAL2V56: встроенный источник опорного на 2.56V (только для Arduino Mega)
  • EXTERNAL: опорным будет считаться напряжение, поданное на пин AREF

Как это влияет на работу? Значение 1023 функции analogRead() будет соответствовать опорному напряжению или выше его, соответственно поставив INTERNAL можно измерять напряжение от 0 до 1.1V с точностью (1.1 / 1023

1.2 мВ), напряжение выше 1.1V будет всегда 1023. После изменения источника опорного напряжения (вызова analogReference) первые несколько измерений могут быть нестабильными.

Нельзя использовать напряжение меньше 0V или выше 5V в качестве внешнего опорного в пин AREF. Также при использовании режима EXTERNAL нужно вызвать analogReference(EXTERNAL) до вызова функции analogRead(), иначе можно повредить микроконтроллер. Также можно подключить опорное в пин AREF через резистор на

5 кОм, но так как вход AREF имеет собственное сопротивление в 32 кОм, реальное опорное будет например 2.5 * 32 / (32 + 5) =

Аппаратные прерывания

Подключить прерывание (читай урок про прерывания) на номер прерывания pin, назначить функцию ISR как обработчик и установить режим прерывания mode:

  • LOW – срабатывает при сигнале LOW на пине
  • RISING – срабатывает при изменении сигнала на пине с LOW на HIGH
  • FALLING – срабатывает при изменении сигнала на пине с HIGH на LOW
  • CHANGE – срабатывает при изменении сигнала (с LOW на HIGH и наоборот)