Arduino и Wiring
Фреймворк Wiring включает простые в использовании функции управления контактами на плате Arduino, однако основная его часть написана на языке C.
До недавнего времени в каталоге установки Arduino IDE можно было найти файл WProgram.h (программа Wiring). Теперь его замещает похожий файл с именем Arduino.h, что свидетельствует о постепенном отдалении Arduino от первоначального проекта Wiring.
Заглянув в каталог установки Arduino IDE, можно увидеть папку hardware, внутри нее — папку arduino, а внутри этой папки — папку cores. Обратите внимание на то, что в Mac в эту папку можно попасть, только если щелкнуть правой кнопкой на ярлыке приложения Arduino, выбрать в контекстном меню пункт View Package Contents (Показать содержимое пакета) и затем перейти в папку Resources/Java/.
Внутри папки cores находится еще одна папка с именем arduino, в которой вы найдете множество заголовочных файлов на языке C с расширением .h и файлов реализации на языке C++ с расширением .cpp (рис. 2.3).
Рис. 2.3. Внутри папки cores
Открыв Arduino.h в текстовом редакторе, вы увидите, что он состоит из множества инструкций #include. Они подключают определения из других заголовочных файлов в папке cores/arduino в процессе компиляции (преобразования скетча в форму, пригодную для записи во флеш-память микроконтроллера).
Там же можно увидеть определения констант, например:
#define HIGH 0x1
#define LOW 0x0
#define INPUT 0x0
#define OUTPUT 0x1
#define INPUT_PULLUP 0x2
Они немного похожи на переменные в том смысле, что, обратившись к имени HIGH, например, программа получит значение 1. Значение определено как 0x1, а не как 1, потому что в этом файле все значения определяются в шестнадцатеричном формате (в системе счисления с основанием 16). Эти определения в действительности не являются переменными — их называют директивами препроцессора C, то есть когда ваш скетч будет преобразован в формат, пригодный для записи во флеш-память микроконтроллера, все слова HIGH, LOW и другие автоматически будут преобразованы в соответствующие числа. Это дает определенные преимущества перед использованием переменных, так как не требуется выделять память для их хранения.
Так как эти константы являются числовыми, вы можете, например, перевести контакт 5 в режим OUTPUT, как показано далее, но все же лучше пользоваться символическими именами на тот случай, если разработчики Arduino решат изменить значения констант. Кроме того, использование имен упрощает чтение программного кода.
setMode(5, 1);
setMode(5, OUTPUT);
Также в файле arduino.h присутствует множество сигнатур функций, например таких:
void pinMode(uint8_t, uint8_t);
void digitalWrite(uint8_t, uint8_t);
int digitalRead(uint8_t);
int analogRead(uint8_t);
void analogReference(uint8_t mode);
void analogWrite(uint8_t, int);
Они предупреждают компилятор о функциях, которые фактически реализуются где-то в другом месте. Возьмем, для примера, первую сигнатуру. Она сообщает, что функция pinMode принимает два аргумента (которые, как вы уже знаете, представляют номер контакта и режим) типа uint8_t. Команда void говорит, что после вызова функция ничего не возвращает.
Вам может показаться странным, почему для параметров выбран тип uint8_t, а не int. Обычно, определяя номер контакта, вы указываете значение типа int. На самом деле int — это универсальный тип, широко используемый в скетчах. Он избавляет пользователей от проблемы выбора из большого разнообразия доступных типов. Но в диалекте языка C для Arduino тип int представляет 16-битные целые значения со знаком в диапазоне между –32 768 и 32 767. Однако номер контакта не может быть отрицательным, и вам едва ли когда-нибудь попадется плата Arduino с 32 767 контактами.
Тип uint_8 намного точнее определяет диапазон допустимых значений, потому что вообще в языке C тип int может представлять значения с разрядностью от 16 до 64 битов в зависимости от конкретной реализации C. Имя типа uint_8 читается так: символ u говорит, что это беззнаковый (unsigned) тип, int сообщает, что это целочисленный тип, и, наконец, число после символа подчеркивания (_) сообщает количество битов. То есть тип uint_8 представляет 8-битные целые числа без знака в диапазоне между 0 и 255.
Вы свободно можете использовать в своих скетчах эти более строгие типы, что некоторые и делают. Но помните, что это сделает ваш код чуть труднее для понимания теми, кто не искушен в программировании для Arduino.
Возможность использования обычного типа int, представляющего 16-битные целые числа со знаком, вместо типа unit_8, например, объясняется способностью компилятора автоматически выполнять необходимые преобразования. Использование переменных типа int для хранения номеров контактов приводит к напрасному расходованию памяти. Поэтому вам придется искать компромисс между объемом памяти для хранения данных и удобочитаемостью кода. Как правило, в программировании предпочтение отдается простоте чтения кода, если только вы не собираетесь создать нечто очень сложное, способное превысить ограничения микроконтроллера.