iarduino_KB

This is a library for Arduino IDE by iArduino.ru. It allows to work with 1x4, 3x4, 4x4V2, 4x4 keyboards

Данная библиотека для Arduino IDE от iArduino.ru позволяет работать с модулями: Эластичная клавиатура 4 кнопки, Эластичная клавиатура 3x4 кнопки, Клавиатура 4 x4 кнопки V2 и Эластичная клавиатура 4 x4 кнопки

Подробнее про установку библиотеки читайте в нашей инструкции.

Подробнее про подключение к Arduino UNO/Piranha UNO читайте в нашем уроке Подключение клавиатуры 4x4 и пьезоизлучателя к Arduino

Модель	Ссылка на магазин
Эластичная клавиатура 4 кнопки	https://iarduino.ru/shop/Expansion-payments/elastichnaya-klaviatura-4-knopki.html
Эластичная клавиатура 3x4 кнопки	https://iarduino.ru/shop/Expansion-payments/elastichnaya-klaviatura-3x4-knopki.html
Клавиатура 4 x4 кнопки V2	https://iarduino.ru/shop/Expansion-payments/klaviatura-4-x4-knopki-v2.html
Эластичная клавиатура 4x4 кнопки	https://iarduino.ru/shop/Sensory-Datchiki/klaviatura-4-4-knopki.html

Назначение функций:

Подключение библиотеки:

#include <iarduino_KB.h>
iarduino_KB ОБЪЕКТ(вывод 1 [,вывод 2 ... [, вывод N]]); // Указываются № выводов arduino подключенных к выводам клавиатуры

В библиотеке реализованы 2 функции:

ОБЪЕКТ.begin();

• Назначение: Инициализация клавиатуры
• Синтаксис: begin(параметр);
• Параметры:
  • KB1 - для эластичной клавиатуры 4x4
  • KB2 - для кнопочной клавиатуры 4x4
  • KB3 - для эластичной клавиатуры 3x4
  • KB4 - для эластичной клавиатуры 1x4
• Возвращаемые значения: Нет
• Примечание: Вызывается 1 раз в начале кода.

ОБЪЕКТ.check();

• Назначение: Определение нажимаемой/отпускаемой/удерживаемой кнопки
• Синтаксис: check([ параметр ]);
• Параметры:
  • KEY_PRESS - функция будет возвращать true пока удерживается кнопка
  • KEY_DOWN - функция вернёт true только при нажатии на кнопку
  • KEY_UP - функция вернёт true только при отпускании кнопки
• Возвращаемые значения: bool true - есть нажимаемая/отпускаемая/удерживаемая кнопка, или false - нет нажимаемых/отпускаемых/удерживаемых кнопок
• Примечание: Вызов функции без параметра, равносилен вызову функции с параметром KEY_PRESS

Переменные:

Указанные переменные доступны для чтения после возврата true функцией check

ОБЪЕКТ.getNum;

• значение кнопки в 16-ричной системе счисления: 0=0, 1=1, 2=2, 3=3, 4=4, 5=5, 6=6, 7=7, 8=8, 9=9, A=10, B=11, C=12, D=13, *=E=14, #=F=15.

ОБЪЕКТ.getChar; 

• символ указанный на кнопке в виде типа char. если кнопка не имеет обозначений, то выводит символы "0"-"9", "A"-"Z" (слева на право, сверху вниз)

Пример:

#include <iarduino_KB.h>            // Подключаем библиотеку для работы с матричной клавиатурой
iarduino_KB KB(9,8,7,6,5,4,3,2);    // Объявляем переменную для работы с матричной клавиатурой,
                                    // указывая номера arduino подключенные к шлейфу клавиатуры, начиная с первого вывода шлейфа.
                                    // Количество параметров соответствует количеству подключенных выводов клавиатуры
void setup()
{
    Serial.begin(9600);              // инициируем подключение к COM-порту на скорости 9600 бод
    KB.begin(KB1);                   // указываем тип клавиатуры
}

void loop()
{
    if(KB.check(KEY_DOWN )){         // если нажимается   кнопка, то ...
//  if(KB.check(KEY_UP   )){         // если отпускается  кнопка, то ...
//  if(KB.check(KEY_PRESS)){         // если удерживается кнопка, то ...
        Serial.print(KB.getNum);     // отправляем символ кнопки в последовательный порт (для вывода цифры кнопки используйте KB.getNum )
        Serial.print(" = \"");
        Serial.print(KB.getChar);    // отправляем символ кнопки в последовательный порт
        Serial.println("\"");
    }
}